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PREFACE 


This manual describes the utility routines for the Series 200/Operating System - Mod 1 
(Mass Storage Resident). These routines provide facilities for: (1) volume initialization, 

(2) data sorting, (3) dumping, (4) disk/tape copy, and (5) volume modification for the Mod 1 
(MSR) Operating System. Besides this manual, other pertinent publications include the 
following: 

Series 200 /Mod 1 (MSR) Operating System Summary Description 
(Order No. 615); 

Supervisor (Order No. 616); 

Program Development Subsystem (Order No. 617); 

Data Management Subsystem (Order No. 618); and 

Operating Procedures (Order No. 620). 

The Summary Description cited above is prerequisite reading to this manual as well as to 
the other manuals listed. In addition, a publications guide is provided in the Summary Descrip- 
tion to aid the reader in his study of the system. 

Section I of this manual provides a brief description of each of the utility routines in the 
Mod 1 (MSR) Operating System. Section II describes Volume Preparation C; Section III de- 
scribes Bootstrap Generator C; Section IV describes Mass Storage Sort C; Section V describes 
Mass Storage Edit C; Section VI describes Disk/Tape Copy C; and Section VII describes Volume 
Modification D. Appendix A describes the method of calculating sort-item block size. Appendix 
B describes general procedures for handling bad tracks on a mass storage volume and pro- 
cedures specific to Volume Preparation C, Mass Storage Sort C, and Disk/Tape Copy C. 


The Mod 1 (MSR) Utility Routines are a set of coded programs designed 
to extend the power of Series 200 in the area of utility functions. They 
are supported by comprehensive documentation and training; periodic 
program maintenance and, where feasible, improvements are furnished 
for the current versions of the programs, provided they are not modi- 
fied by the user. 
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NEW AND CHANGED INFORMATION 


This edition has been revised to reflect extensions to the Mod 1 (MSR) Operating System. 

£ Section VII has been added to describe a new routine, Volume Modification D. Volume Prepara- 

tion C has been augmented to include several new features, including the ability to provide sub- 
g. stitute tracks for bad tracks on the mass storage volume being prepared. Disk/Tape Copy C 

now includes two copy methods, copy -by-rectangle and copy-named -files, which can be used 
with all copy options. Appendix B has been added to describe general procedures for handling 
bad tracks on a mass storage volume and procedures specific to Volume Preparation C, Mass 
Storage Sort C, and Disk/Tape Copy C. 

This edition contains no references to loading utility routines from cards. 
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SECTION I 
INTRODUCTION 


The utility routines of the Series 200/Operating System — Mod 1 (Mass Storage Resident) 
provide facilities for: (1) volume initialization, (2) data sorting, (3) dumping, (4) disk/tape copy, 
and (5) volume modification for mass storage. These utility routines are Volume Preparation C, 
Bootstrap Generator C, Mass Storage Sort C, Mass Storage Edit C, Disk/Tape Copy C, and Vol- 
ume Modification D. 

VOLUME PREPARATION C 

Volume Preparation C prepares a mass storage volume for use under the data management 
conventions of the operating system. This routine formats tracks of the volume while checking 
for bad surface areas, writes the volume label, and creates the volume directory. The routine 
can be directed to provide substitute tracks for bad tracks on the volume. Volume Preparation C 
must be performed once for every mass storage volume at the time the volume is first entered 
into the operating system. 

BOOTSTRAP GENERATOR C 

Bootstrap Generator C creates a bootstrap routine on a mass storage volume. Bootstrap 
Generator C can also re-create a bootstrap routine at any time after its initial creation and spe- 
cialize it for the requirements of a specific installation. The bootstrap routine is used to bring 
the Supervisor into main memory from mass storage. 

MASS STORAGE SORT C 

Mass Storage Sort C can sort items from a mass storage, card, or tape file, using work 
areas on a mass storage volume. The principal operation is a key sort, in which the sort key 
fields are taken from source items and only the keys are sorted. The Fetch macro routine is 
used to retrieve the sorted keys and the associated source items. If desired, selected fields can 
be extracted from each source item and carried through the sort process along with the key. The 
output of the sort then contains the extracted fields as well as the sort keys. At this point, the 
Fetch macro routine is used to retrieve these extract fields from the sorted output, thus elimina- 
ting the necessity of retrieving them from the original source items. 

A further option of Mass Storage Sort C permits the entire source item to be sorted. This 
method of sorting eliminates the need to retrieve fields from the source items. 
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The sequential output file program can be used to create a sequential mass storage file (as 
described in the Mod 1 (MSR) Data Management Subsystem manual) or a tape file of the source 
items in the sorted output sequence. 

MASS STORAGE EDIT C 

Mass Storage Edit C provides a printed representation of the physical data stored on a mass 
storage volume. Parameters to the edit routine specify the area(s) to be edited. The edit rou- 
tine does not recognize the existence of files as such; therefore, a user wishing to produce a 
listing of a specific file should refer to the Mod 1 (MSR) Data Management Subsystem manual. 

DISK /TAPE COPY C 

Disk/Tape Copy C provides a fast method of copying rectangular areas or named files from 
a mass storage volume for backup purposes. Disk/Tape Copy C copies up to 16 rectangular areas 
or any number of named files from a mass storage volume onto another mass storage volume or 
onto magnetic tape. The copy on magnetic tape may subsequently be written back, in whole or in 
part, onto a mass storage volume by this same routine. 

VOLUME MODIFICATION D 

Volume Modification D is used to create the track substitution capability on a mass storage 
volume, if this capability was not previously created by Volume Preparation C. After the track 
substitution capability is created, Volume Modification D can be used to provide substitute tracks 
for known bad tracks that were not provided with substitutes during Volume Preparation C. At 
the end of the run, Volume Modification D produces a printer listing of all bad tracks for which 
substitute tracks have been provided and all substitute tracks on the volume. 

UTILITY ROUTINES IN A MULTIPROGRAMMING ENVIRONMENT 

Volume Preparation C, Mass Storage Edit C, and Volume Modification C cannot be run in a 
multiprogramming environment. Other utility routines of the Mod 1 (MSR) Operating System can 
be run in a multiprogramming environment, but only as background programs. 

Assignments of read/write channels are made automatically. When a utility routine operates 
in a single-job environment, it makes optimum use of all available read/write channels. When a 
utility routine is run as a background program in a multiprogramming environment, it does not 
use read/write channel 1: that channel is reserved exclusively for the foreground program. 
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VOLUME PREPARATION C 


Volume Preparation C is a utility routine of the Mod 1 (MSR) Operating System. The 
routine prepares a mass storage volume for use under the system's data management conven- 
tions. (For a description of these conventions, see the Data M anagement Subsystem manual.) 

Volume Preparation C must be run for each mass storage volume as it is first entered 
into the operating system. Thereafter, whenever reformatting of the entire volume is desired. 
Volume Preparation C must be run again. 

Volume Preparation C cannot be run in a multiprogramming environment. 

EQUIPMENT REQUIREMENTS FOR VOLUME PREPARATION C 

Basic Equipment Requirements 

The following basic equipment is required: 

A Series 200 central processor; 

Advanced Programming Instructions; 

12, 288 characters of main memory; and 
One disk device and associated control. 


This combination may be any one of the following. 


Device Type 

Control Type 

155 

157C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

259A 1 

257A 

259B 1 

257B 

261 

260 

262 

260 


I 


^When a mass storage volume is mounted on a Type 259A or 
259B Disk Pack Drive, the value 259 must be used in the 
device-type parameter. Omitting the device-type parameter 
produces the same effect in this case, since 259 is the assumed 
value if no device type is specified. 


Also required are one card reader and one printer. 
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Additional Usable Equipment 

The following additional equipment may be used: 

One Type 220-1, -3 Console (console I/O requires 4,096 additional characters of 
main memory); 

Second I/O Sector (Feature 1115 for Model 2200); and 
One or more additional disk devices as tabulated above. 

FUNCTIONAL DESCRIPTION OF VOLUME PREPARATION C 
Volume Preparation C performs the following functions: 

1. Writes the volume label, 

2. Creates the volume directory, and 

3. Checks for bad disk surface areas 1 by formatting either the entire mass 
storage volume or only certain critical tracks (see the "Surface-Check 
Parameter" later in this section). 

When Volume Preparation C formats the entire mass storage volume, each track (except 
for those tracks reserved for system use on cylinder 000) is formatted so that it consists of 
equal length physical records with no track-linking records. 

The length of the physical records on each track is determined by the device type specified 
(or defaulted) in the device -type parameter of the job control file. The record lengths are as 
follows : 


Device Type 

Length of Record 

155, 258, 259, 273 
261, 262 

271 characters 
256 characters 


After being formatted, each track is read back. If an error occurs that cannot be corrected 
by reformatting, the routine uses a bad track handling procedure. 1 

JOB CONTROL LANGUAGE FOR VOLUME PREPARATION C 

In order to execute Volume Preparation C, a job control file, consisting of a series of job 
control statements, must be placed in the card reader. Each job control statement contains one 
or more parameters. 

In the following description of job control statements, the term "line" is the equivalent of 
one card in the job control file. 

^"Bad Track Handling Procedures for Volume Preparation C" appears in Appendix B of this manual. 
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Sequence of Job Control Statements 

Job control statements for Volume Preparation C must appear in the following order: * 

1. Execute statement (if the routine is to be loaded from mass storage), 

2. Volume statement, 

3. File statement (if present), and 

4. Day statement (if present). 

The last line of the last job control statement must contain an E in its mark field or be 
followed by a line with blanks in its operation code and operands fields and an E in its mark 
field. 

Figure 2-1 shows the basic set of job control statements for Volume Preparation C. 
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Figure 2-1. Job Control Statements for Volume Preparation C 
Execute Statement 

The Execute statement is used only when Volume Preparation C is to be loaded from mass 
storage. The Execute statement directs the Supervisor to load Volume Preparation C from the 
system disk, which is mounted on logical drive number 0. An additional mass storage device, 
whose drive number can be from 1 through 7, is required for the volume being prepared (unless 
the system residence volume is being prepared). An Execute statement is required for every 
run of this routine when it is mass storage resident. 


I 


See Appendix B for additional job control language elements that apply to bad track handling. 
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The Execute statement is not used when Volume Preparation C is loaded from magnetic 
tape. (A drive number from 0 through 7 can be assigned to the mass storage device holding 
the volume being prepared. ) For a description of loading from magnetic tape, see "Operating 
Procedures for Volume Preparation C, " later in this section. 

Volume Statement 

The Volume statement is required for every run of Volume Preparation C because the 
name of the volume to be prepared must always be specified in the volume -name parameter. 

All other parameters of the Volume statement are optional; if these parameters are omitted, 
their default values are used during processing. 

VOLUME-NAME PARAMETER 

The volume -name parameter (NAME) is required for every run of Volume Preparation C. 
The volume-name parameter provides the name to be written onto the volume label. The form of 
this parameter is shown below. 

| NAME = volume -name, 

volume -name = This name can be from one through six alphanumeric characters in 
length. Letters A through Z and numbers 0 through 9 can be used. 

The last character must be directly followed by a comma. If fewer 
than six characters are specified, this field on the volume label is 
zero -filled to the left. 

VOLUME -SERIAL-NUMBER PARAMETER 

This parameter allows the user to specify an alphanumeric value, up to six characters in 
length, which supplements the volume name in identifying the mass storage volume. Like the 
volume name, the volume serial number is written onto the volume label. The form of this 
parameter is shown below. 

|^SERIAL^=^volume^-serial-numbe^ 

volume -serial -number = This value may be up to six alphanumeric characters in 

length. If fewer than six characters are specified, this 
field on the volume label is zero-filled to the left. 

Default assumption: if this parameter is omitted, the volume name is also written into 

the volume -serial-number field on the volume label. 

VOLUME-SERIAL-NUMBER-CHECK PARAMETER 

This parameter enables the user to insure that the correct volume has been mounted. 

When this parameter contains the keyword value YES (or when the parameter is omitted), the 
volume-serial-number field on the volume label is checked for equality with the value specified 
in the volume-serial-number parameter. In this case, the volume-serial-number parameter 
must be specified. The form of this parameter is shown below. 
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CHECK = 


YES 

NO 


YES = The volume -serial -number field of the volume label is checked for equality 
With the value specified in the volume-serial-number parameter. If 
inequality results, a halt or console message occurs. 

NO = The above check is not performed. If the volume -serial -number parameter 
is specified, its value is written into the volume -serial -number field on the 
volume label. If the volume-serial-number parameter is not specified, the 
volume name is written into the volume -serial-number field on the volume 
label. 

Default assumption: YES 

SURFACE -CHECK PARAMETER 

This parameter enables the user to specify whether formatting and surface checking are 
to be performed for the entire mass storage volume or only for certain critical tracks. The 
form of this parameter is shown below. 


YES 


* 


FORMAT = 


YES 

NO 


The entire mass storage volume is to be formatted and checked for bad 
tracks . 


NO = Only the following areas are to be formatted and checked for bad tracks: 
the bootstrap track, the substitute bootstrap track, the volume label, 
the volume directory, the *BADTRACKS file (if created), and the 
*VOLSPARES file (if created). 1 

Default assumption: YES 


MAXIMUM-NUMBER -OF- FILES PARAMETER 

The maximum-number-of-files parameter designates the maximum number of files that 
are expected to be stored on the volume being prepared. Sufficient space is allowed in the 
volume directory to accommodate the number of files designated by this parameter. 


The user may specify a number from 1 to 26 for a volume mounted on a Type 155 Disk 
Pack Drive or 1 to 86 for a volume mounted on a Type 258, 259, 273, 259A, or 259B Disk Pack 
Drive. A number from 1 to 158 may be specified for a volume mounted on a Type 261 or 262 
Disk File. Volume Preparation C uses a standard value for the maximum number of files, based 
on the value specified by the user (see Table 2-1 and 2-2). 


*The *BADTRACKS and *VOLSPARES files are described in Appendix B under "Bad Track 
Handling Procedures for Volume Preparation C. " 
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The user must specify an adequate number of files since the only means of increasing the 
number of files allowed is to (1) unload all files, (2) run Volume Preparation C with a larger 
value in the maximum-number-of-files parameter, and (3) reallocate and reload all files. 


The form of this parameter is shown below. 


j MAXF = maximum-number -of-files, 


I 

I 


maximum-number-of-files = A decimal number from 1 to 26 for the Type 155 Disk 

Pack Drive or 1 to 86 for Type 258, 259, 273, 259A, and 
259B Disk Pack Drives; from 1 to 158 for Type 261 and 
262 Disk Files. 


NOTE: The MAXF parameter card is not required for the Type 155 Disk Pack Drive as 

MAXF is always set to 26. Tracks reserved for the Volume Directory are cylin- 
der 00, track 01, records 1 through 14, and cylinder 01, tracks 00 and 01. 


The user-specified value produces a standard value used by Volume Preparation C as 
shown in the following tables . 


Table 2-1. MAXF Values for Type 258, 259, 273, 259A, and 259B Disk Pack Drives 


Value Specified 
by User 

Value Used by Volume 
Preparation C 

Tracks on Cylinder 000 
Reserved for Volume 
Directory 

None (default) 

26 

2 - 4 

1 - 26 

26 

2-4 

27 - 56 

56 

2-6 

57 - 86 

86 

2-8 

Greater than 86 

Invalid parameter value 
halt or console message 
occurs. 



Table 2-2. MAXF Values for Type 261 and 262 Disk Files 


Value Specified 
by User 

Value Used by Volume 
Preparation C 

Tracks on Cylinder 000 
Reserved for Volume 
Directory 

None (default) 

50 

2 - 4 

1 - 50 

50 

2-4 

51 - 104 

104 

2-6 

105 - 158 

158 

2-8 

Greater than 158 

Invalid parameter value 
halt or console message 
occurs. 



Default assumption: if this parameter is omitted, the value 26 is used for a volume 

mounted on a Type 155, 258, 259, 273, 259A, or 259B Disk Pack 
Drive: the value 50 is used for a Type 261 or 262 Disk File. 
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DEVICE-TYPE PARAMETER 


The device -type parameter (DEVTYPE) specifies the type of device that holds the volume 
to be prepared. The form of this parameter is shown below. 


DEVTYPE 


155 

258 

259 
273 
261 
262 
261L 

1262L/ 


If the volume to be prepared is mounted on a Type 259A or 259B Disk Pack Drive, the 


value 259 must be used in the device -type parameter. Omitting the parameter produces the 
same effect in this case, since the default value is 259. 


If a Type 262 Disk File is specified in this parameter. Volume Preparation C prepares 
only the one volume whose address is specified (or defaulted) in the device -address parameter. 


Default assumption: if this parameter is omitted, the value 259 is used. 

DEVICE -ADDRESS PARAMETER 

The device -address parameter (DEVADD) indicates the address of the disk device holding 
the volume to be prepared. The form of this parameter is shown below. 

|^DEVADD = (pcUjdrive), 

pcu = The peripheral control unit number, written as two octal characters. 

The I/O bit is not used, but all other bits, including sector bits, must 
be specified. 

drive = The drive number, written as one octal character. 

Default assumption: if this parameter is omitted, the default assumption is pcu 

04, drive 0. 

File Statement for the List File 

The list file is a printer listing of bad tracks, if any, and their substitutes on the volume 
being prepared. The list file is described in Appendix B of this manual under "Bad Track 
Handling Procedures for Volume Preparation C. " 

The File statement for the list file is required only when the printer is assigned a periph- 
eral control address other than 02. If this statement is omitted, the printer's peripheral 
control address is assumed to be 02. 

The form of this statement is shown in lines 14 and 15 of Figure 2-1. 
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DEVICE -ADDRESS PARAMETER 

This parameter is required when the File statement for the list file is used. This parame- 
ter specifies the address of the printer's peripheral control unit. The form of this parameter 
is shown below. 


|PEVADD = (pc u) , 

pcu = The peripheral control unit number, written as two octal characters. The 
I/O bit is not used, but all other bits, including the sector bits, must be 
specified. 


Day Statement 

The Day statement is optional. It is used to specify the creation date of the system files 
created by Volume Preparation C. When specified, the date is entered into the file description 
index item for each system file created by Volume Preparation C. 

The form of this statement is shown on line 16 of Figure 2-1. The "yy" portion of the 
statement gives the year of the creation in decimal digits; the "ddd" portion gives the day of 
the creation in decimal digits (January 1st being day 001). 

Default assumption: if this statement is omitted, the creation date is taken from the 

current date field of the Supervisor. 

OPERATING PROCEDURES FOR VOLUME PREPARATION C 

Loading Volume Preparation C 

Volume Preparation C can be loaded in two ways. 

1. From mass storage, by means of the Supervisor, under the Mod 1 (MSR) 

Operating System; 

2. From magnetic tape, by means of Floating Tape Loader -Monitor C, under 
the Mod 1 (TR) Operating System. 

MASS STORAGE RESIDENT 

When Volume Preparation C is loaded from mass storage, an Execute statement (as illus- 
trated on line 1 of Figure 2-1) must be submitted in the job control file, followed by the desired 
job control statements for the routine. 

TAPE RESIDENT 

Loading Volume Preparation C from magnetic tape is similar to loading from mass storage, 
except that a console call card is used instead of an Execute statement. The format of the console 
call card is shown in Table 2-3. 
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Table 2-3. Console Call Card Format 


| Characters 

Contents 

Meaning 

00 

1 

rH 

*VOLPREP 

Program and segment names 
for Volume Preparation C 

9 

d 

Tape drive number from which 
Volume Preparation C is to be 
loaded 

18 

* 

Asterisk (required by the Mod 1 
(TR) Operating System) 


Protection Switch Settings 

Before running Volume Preparation C, the user must set to PERMIT all protection 
switches on the peripheral control unit of the disk device holding the volume to be prepared. 

Operator Communication and Control 

When an error condition occurs, 2 -way communication between the operating system and 
the operator is achieved through a control panel or (if certain software and hardware require- 
ments have been met) through a console. If the communication medium is a control panel, an 
error condition causes the central processor to halt. If the communication medium is a console, 
an error condition causes a message to appear, but the central processor does not halt. 

Halts or console messages are caused by three types of error conditions: peripheral 
device conditions, job control file conditions, and conditions specific to Volume Preparation C. 
When a halt or console message occurs, the operator must determine which error condition 
exists and then make the appropriate response. 

CONTROL PANEL HALTS 

At the time of a control panel halt, the B -address register contains a value that identifies 
the error condition. In all cases except for card read errors, the A-address register contains 
the address of a response location in main memory. The response location is a 1-character 
main memory location into which the operator must enter a response character appropriate to 
the error involved. Where indicated, additional information concerning the error can be found 
in the main memory locations immediately following the response location. This additional 
information is called the supplementary list (see Table 2-4) and is composed of the following 
elements (arranged in ascending order of contiguous main memory locations). 
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Table 2-4. Supplementary List 


Field Name 

Length 

Specific code* 

One character (A+l) 

Volume name 

Six characters 

Volume serial number 

Six characters 

Mass storage pcu address 

One character 

Device address 

One character 

Magazine number 

One character (always 0) 

Error address * 

Six characters in the decimal 
format cccttt 

^Significant only for certain mass storage peripheral device errors 
(otherwise blank). 


Peripheral Device Halts 

A B -address register value in the range from 0000 through 3777 indicates an error condi- 
tion involving a peripheral device. The operator should consult Table 2-5. The B-address 
register value has the general form ppxd, where: 

pp = Peripheral control unit (leftmost bit set to zero); 
x = Code indicating type of error condition: 

0 = Device not operable, 

1 = Uncorrectable read error, 

2 = Uncorrectable write error, and 
4 = Positioning error; 

d = Device number. 

These values are consistent with the standard peripheral error halt codes. 

When the halt condition involves the card reader, the A-address register does not contain 
meaningful values. In all other cases, the A-address register contains the response location. 
The supplementary list is also present (see Table 2-4). 
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Table 2-5. Peripheral Device Halts 


B - Address 

Register 

Contents 

Specific 

Code 

(A+l) 

Condition 

Operator Action^ 

ppOd 

01 

Device inoperable. 

G = retry. 


02 

Protection violation. 


ppld 


Read error (cards). 

Correct erroneous card, if 
possible; refeed cards, start- 
ing with that card; and press 
RUN. 

pp2d 

04 

F ormat violation. 

G = retry. 


12 

Track overflow. 

E = exit to the Supervisor. 


10 

Write error. 2 

G = retry. 




S = skip the bad track and 
resume processing. 




E = exit to the Supervisor. 

pp4d 

03 

Positioning error. 

G = retry. 




E = exit to the Supervisor. 


13 

Positioning error. 

E = exit to the Supervisor. 


The operator enters the appropriate response character into the response location 

and presses RUN (G = 27 , S = 62 , E = 25 ). 

o o o 


2 

If *BADTRACKS and *VOLSPARES files have not been created on the volume and 
a bad track is encountered during formatting (write error), the following message 
appears on the printer: CYL nnn TR nnn ERROR (nnn is a decimal value). If 
*BADTRACKS and *VOLSPARES files have been created on the volume and an 
unusable track is encountered (write error), the printer message is CYL nnn TR 
nnn UNUSABLE. An unusable track (a very unlikely possibility) has a bad sur- 
face and not even one bad-track track-linking record can be read from it. 


Job Control File Halts 

A B-address register value from 5000 through 5077 indicates an error condition related to 
statements of the job control file (see Table 2-6). The operator decides what action is required 
and enters the appropriate response character into the response location in the A-address reg- 
ister. The supplementary list is not produced. 
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Table 2-6. Job Control File Halts 


B -Address 

Register 

Contents 

Condition 

Operator Action 

5001 

Invalid command field. 

G = attempt to perform the operation 
again. The operator corrects the 
erroneous job control statement; 
refeeds the cards, starting with 
the Volume statement; enters a 
G and presses RUN. The pro- 
gram then reprocesses the job 
control file. 

E = exit to the Supervisor. 

5002 

Invalid positional 
parameter. 

5003 

Invalid keyword. 

5004 

Required parameter 
missing. 

5005 

Invalid keyword 
parameter value. 

5010 

Invalid combination or 
sequence of parameters. 

1 NOTE: G = 27 g , E = 25 g . 


Halts Specific to Volume Preparation C 

A B-address register value from 6500 through 6517 indicates an error condition specific to 
Volume Preparation C. 1 See Table 2-7. The A-address register contains the address of the 
response location. The supplementary list is also present (see Table 2-4). 


Table 2-7. Halts Specific to Volume Preparation C 


B -Address 

Register 

Contents 

Condition 

Operator Action-^ 

6500 

The volume to be prepared is 
the volume on which the system 
resides. 

G = refeed the job control file from 
the Volume statement, after 
changing the address of the 
volume to be prepared; enter G 
and press RUN. 

A = accept the situation and perform 

volume preparation on this volume. 

E = exit to the Supervisor. 

6501 

This halt occurs at the end of 
Volume Preparation C only 
when a 6500 halt has occurred 
earlier in the run and the A 
response has been given. A 
system residence volume must 
now be assigned to drive num- 
ber 0 so that control can be 
transferred to the Supervisor. 

If no legitimate system residence volume 
now exists, the run can be considered 
complete at this point and no response 
is necessary. 

G = reassign a system residence vol- 
ume to drive number 0, enter G 
and press RUN. Volume Prepara- 
tion C will return control to the 
Supervisor . 


Appendix B contains a description of halts in this category that apply to bad tracks on the volume 
being prepared. 
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Table 2-7 (cont). Halts Specific to Volume Preparation C 


B -Address 

Register 

Contents 

Condition 

Operator Action^ 

6505 

The volume-serial-number 
check failed. 

G = reread the volume label. 
E = exit to the Supervisor. 

^The operator enters the appropriate response character and presses RUN 
(G = 27 g , A = 2 1 g , E = 25 g ). 


CONSOLE MESSAGES 

The console can be used for operator control when the Supervisor (in the Mod 1 (MSR) 
Operating System) or Floating Tape Loader -Monitor (in the Mod 1 (TR) Operating System) has 
been appropriately specialized and at least 16, 384 characters of main memory are available. 

If either of these two conditions is not met, however, the operator's control medium is the 
control panel. 

When the console is used for operator control, an error condition does not cause the 
system to halt. Instead, a diagnostic message is typed out on the console. The operator takes 
the following steps. 

1. He reads the typeout. (To repeat the message, he presses the space bar twice. ) 

If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1-character response (G, E, etc.). 

4. If the typein is correct, he presses the space bar to continue. If it is incorrect, 
he types any nonspace character and returns to step 3. 

The routine continues as directed by the response code. If an invalid response is made, the 

routine causes the diagnostic message to reappear. 

The following paragraphs provide detailed information about the three kinds of console 
messages that can occur during Volume Preparation C. 

Peripheral Device Messages 

Console messages relating to peripheral device error conditions are listed in Table 2-8. 
The format of these messages is 

pp d MESSAGE TEXT 

where pp = Peripheral control unit (leftmost bit set to zero), 
d = Device number, and 
MESSAGE TEXT specifies the error condition. 

A second line contains the supplementary list described in Table 2-4. 
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Table 2-8. Peripheral Device Messages 


Typewriter Message 

Specific 

Code 

(alphanumeric ) 

Condition 

Operator Action* 

pp d INOPERABLE 

1 

Device inoperable. 

G = retry. 


2 

Protection violation. 

E = exit to the 
Supervisor. 

pp d READ ERROR 


Read error (cards). 

Correct erroneous 
card, if possible; 
refeed cards, start- 
ing with that card; 
and press the space 
bar. 

pp d WRITE ERROR 

4 

Format violation. 

G = retry. 


1 

Track overflow. 

E = exit to the 
Supervisor. 


8 

2 

Write error. 

G = retry. 

S = skip the bad 
track and 
resume proces- 
sing. 

E = exit to the 
Supervisor. 

pp d POSITIONING 
ERROR 

3 

Positioning error. 

G = retry. 

E = exit to the 
Supervisor. 


= 

Positioning error. 

E = exit to the 
Supervisor. 


The operator types the appropriate alphabetic response character and presses the 
space bar. 

2 

If *BADTRACKS and *VOLSPARES files have not been created on the volume and a 
bad track is encountered during formatting (write error), the following message 
appears on the printer: CYL nnn TR nnn ERROR (nnn is a decimal value). If 
*BADTRACKS and *VOLSPARES files have been created on the volume and an 
unusable track is encountered (write error), the printer message is CYL nnn TR 
nnn UNUSABLE. An unusable track (a very unlikely possibility) has a bad surface 
and not even one bad-track track-linking record can be read from it. 


Job Control File Messages 

All messages involving errors in the job control file begin with the words JOB CONTROL 
FILE ERROR. Table 2-9 contains the complete texts of all job control file messages for 
Volume Preparation C. No supplementary list is produced. 
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Table 2-9. Job Control File Messages 


Typewriter Message 

Condition 

Operator Action 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Invalid command field. 

G = attempt to perform 
the operation again. 
The operator corrects 
the erroneous job 
control statement; 
refeeds cards, start- 
ing with the Volume 
statement; types a G 
and presses the space 
bar. The program 
then reprocesses 
the job control file. 

E = exit to the Supervisor. 

JOB CONTROL FILE ERROR, 
POSITIONAL PARAMETER 

Invalid positional 
parameter. 

JOB CONTROL FILE ERROR, 
KEYWORD PARAMETER 

Invalid keyword. 

JOB CONTROL FILE ERROR, 
MISSING PARAMETER 

Required parameter 
missing. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Invalid keyword 
parameter value. 

JOB CONTROL FILE ERROR, 
PARAMETER COMBINATION 

Invalid combination 
or sequence of 
parameters . 


Messages Specific to Volume Preparation C 

Table 2-10 contains messages for error conditions specific to Volume Preparation C. * 
The messages in Table 2-10 are followed by a second line of typed information, which contains 
the supplementary list described in Table 2-4. 


Appendix B contains messages in this category that apply to bad tracks on the volume being 
prepared. 
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Table 2-10. Messages Specific to Volume Preparation C 


Typewriter Message 

Condition 

Operator Action* 

SYSTEM RESIDENCE 
VOLUME WILL BE 
FORMATTED 

The volume to be 
prepared is the 
volume on which the 
system resides. 

G = refeed the job control 
file from the Volume 
statement, after changing 
the address of the volume 
to be prepared; type G 
and press the space bar. 

A = accept the situation and 
perform volume prepara- 
tion on this volume. 

E = exit to the Supervisor. 

REASSIGN SYSTEM RESIDENCE 
VOLUME TO DEVICE 0 

This message occurs 
at the end of Volume 
Preparation C only 
when the above mes- 
sage has occurred 
earlier in the run and 
the A response has 
been given. A system 
residence volume must 
now be assigned to 
drive number 0 so that 
control can be trans- 
ferred to the Supervisor. 

If no legitimate system resi- 
dence volume now exists, the 
run can be considered com- 
plete at this point and no re- 
sponse is necessary. 

G = reassign a system resi- 
dence volume to drive 
number 0, type a G and 
press the space bar. 
Volume Preparation C 
will return control to the 
Supervisor. 

INCORRECT VOLUME 

The volume-serial- 
number check failed. 

G = reread the volume label. 
E = exit to the Supervisor. 

*The operator types the appropriate alphabetic response character and presses the space bar. 
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BOOTSTRAP GENERATOR C 


Bootstrap Generator C creates a bootstrap routine on a mass storage volume. The boot- 
strap routine is the program that brings the Supervisor into main memory from mass storage at 
the beginning of operations with the Mod 1 (MSR) Operating System. 

Bootstrap Generator C has the capability to perform the following: 

1. Create the bootstrap routine; 

2. Recreate the bootstrap routine at any time after its initial creation; and 

3. Specialize the bootstrap routine for the requirements of a specific installa- 
tion, so that it is possible to bootstrap the Supervisor without any halts 

for parameter changes. 

Bootstrap Generator C is normally run when the operating system is generated for a 
particular installation. However, it can be run whenever it is necessary to condition a mass 
storage volume so that the Supervisor may be bootstrapped from it. This conditioning may be 
necessary if the installation is to run the Supervisor from more than one volume or to change 
some parameters of the bootstrap routine. In either case, the mass storage volume must first 
have been prepared with the Volume Preparation C routine. 

Bootstrap Generator C has been designed to operate under the control of any of the moni- * 
tors listed below: 

1. The Supervisor, or 

2. Any loader -monitor in the Series 200/Operating System - Mod 1 (Tape 
Resident). 

The reader should be familiar with the operating procedures for the Supervisor, as de- 
scribed in the Supervisor manual (Order No. 616). 

EQUIPMENT REQUIREMENTS FOR BOOTSTRAP GENERATOR C 
Basic Equipment Requirements 

The equipment requirements for Bootstrap Generator C are listed below: 

A Series 200 central processor; 

Advanced Programming Instructions; 
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12,288 characters of main memory; and 
One disk device and associated control. 

This combination can be any one of the following. 


Device Type 

Control Type 

155 

1 57C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

259A 

257A 

259B 

257B 

261 

260 

262 

260 


One card reader is also required. 

Additional Usable Equipment 

The following additional equipment also can be used: 

One Type 220-1, -3 Console (console I/O requires 4,096 additional characters 
of main memory); 

Second I/O Sector (Feature 1115 for Model 2200); and 
One or more additional disk devices as tabulated above. 

FUNCTIONAL DESCRIPTION OF BOOTSTRAP GENERATOR C 

Bootstrap Generator C accepts the following parameters to create a bootstrap routine 
tailored for a particular Supervisor: 

1. Unique Supervisor identification; 

supervisor's relocation bank indicator; 

Address of mass storage control from which the bootstrap routine will be 
xecuted; 

ddress of mass storage control and drive number of the volume on which 
ootstrap Generator C is to write the bootstrap routine; and 

_*sk transfer rate required at bootstrap time. 

These parameters are specified through job control statements which are processed by the 
Bootstrap Generator C to specialize the bootstrap routine and write it onto a mass storage 
volume. Each of these parameters is described in more detail in the following paragraphs. 

Supervisor Name 

The Supervisor can exist in more than one version in the residence file. Each version is 


identified by the last character of the Supervisor's name. 
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During bootstrap generation, the user specifies which version of the Supervisor will be 
used most often and, therefore, will be loaded automatically by the bootstrap routine. This 
version of the Supervisor is referred to as the prime Supervisor. The term "prime" does not 
imply, however, that only one version of the Supervisor can be bootstrapped; the bootstrap 
procedure has an option to alter the Supervisor name and thus load another version. Also, 
the Supervisor can load any other version of itself through an Execute statement. 

Location of Supervisor in Main Memory 

Bootstrap Generator C can create a bootstrap routine that will relocate the Supervisor to a 
specific bank of main memory. This value can also be altered at bootstrap time. 

Control Address for Bootstrap Routine- 

Bootstrap Generator C can specialize the bootstrap routine for a specific peripheral ad- 
dress assignment for the mass storage control. This value can also be altered at bootstrap time. 

Device Address, for Writing Bootstrap Routine 

Bootstrap Generator C can write the bootstrap routine onto a volume having any mass 
storage control and device address. This parameter applies only at the time the bootstrap rou- 
tine is generated. It allows Bootstrap Generator C to be loaded from one mass storage volume 
and to write the bootstrap routine onto another mass storage volume. 

JOB CONTROL LANGUAGE FOR BOOTSTRAP GENERATOR C 

Information to specialize the bootstrap routine is submitted through the job control file. 

The job control file must be assigned to a card reader. 

Job control statements for Bootstrap Generator C (see Figure 3-1) are Execute, Supervisor, 
Read/Write Channel, and File. The Supervisor, Read/Write Channel, and File statements can 
be omitted; in which case certain values are assumed. (The Execute statement can be absent, 
or it can be replaced by a console call card if Bootstrap Generator C is not operated under the 
Mod 1 (MSR) Operating System. Refer to page 3-6 for operating procedures in a non-mass 
storage environment. ) 

To terminate the reading of job control statements, the character E must appear in the 
mark field of the last line of the last job control statement. The E must not appear in the 
Execute statement; therefore, if no other job control statements are submitted, a line containing 
E must still appear. 
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Figure 3-1. Job Control Statements for Bootstrap Generator C 


Execute Statement 

The Execute statement directs the Supervisor to load Bootstrap Generator C. It must be 
the first statement in the job control file if Bootstrap Generator C is run under the control of the 
Supervisor. *BOOTGEN is the name of the Bootstrap Generator C program. A halt name may 
also appear (as described in the Supervisor manual). 

Supervisor Statement 

The Supervisor statement specializes the bootstrap routine with the name of the prime 
Supervisor and the relocation bank indicator. If the Supervisor statement is not supplied, 
Bootstrap Generator C assumes that: 

1. The Supervisor name is SUPER1; and 

2. The relocation bank indicator is 02 (specifying a memory size of 12K 
characters). 

SUPERVISOR NAME PARAMETER 

The Supervisor name parameter (NAME) specifies the last character of the name of the 
prime Supervisor. The format of this parameter is shown below. 

| NAME=x, 

x - The last character of the name of the prime Supervisor. This character must 
be chosen from the letters (A-Z) or the digits (0-9). The entire name of the 
prime Supervisor is thus "SUPERx. " 

The default assumption is 1. 

RELOCATION BANK INDICATOR PARAMETER 

The relocation bank indicator parameter (BANK) specifies the bank in which the Supervisor 
is to reside. The format of this parameter is as follows. 

| BANK=bb, 
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bb — The relocation bank indicator, expressed as two octal characters. This 
parameter is chosen according to Table 3-1. 

The default assumption is 02. 


Table 3-1. Relocation Bank Indicator Parameter Values 


Memory 

Size 

Highest Location Used by the 
Supervisor (octal) 

Relocation 

Indicator 

12K 

02 77 77 

02 

16K 

03 77 77 

03 

2 OK 

04 77 77 

04 

24K 

05 77 77 

05 

28K 

06 77 77 

06 

32K 

07 77 77 

07 

40K 

11 77 77 

11 

49K 

13 77 77 

13 

57K 

15 77 77 

15 

65K 

17 77 77 

17 

8 IK 

23 77 77 

23 

98K 

27 77 77 

27 

1 14K 

33 77 77 

33 

13 IK 

37 77 77 

37 

163K 

47 77 77 

47 

196K 

57 77 77 

57 

229K 

67 77 77 

67 

262K 

77 77 77 

77 


RWC Statement 

FAST gives an RWC variant of 56 or 76, depending on the sector bits specified in the FILE 
BOOT statement. 

SLOW gives an RWC variant of 53 or 73. 

The default value is FAST. 

File Statements 

File statements specify nonstandard control and device addresses for the two mass storage 
devices referred to by Bootstrap Generator C. These are: 

1. Bootstrap Generator C device — the device onto which Bootstrap Generator 
C writes the bootstrap routine; and 

2. Bootstrap device — the device to be used later for the bootstrap operation. 

If no File statements are supplied, these control and device addresses are assumed to be: 

1. Bootstrap Generator C device — control 04, drive 0; and 

2. Bootstrap device — control 04 (drive number is not relevant). 

FUNCTIONAL -NAME PARAMETER 

The functional-name parameter identifies the function to which the File statement applies. 
This parameter has the following format. 

(GEN 
l BOOT ’ 
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GEN - Bootstrap Generator C device — the device onto which Bootstrap Generator 
C writes the bootstrap routine. 

BOOT - Bootstrap device — the device to be used for subsequent bootstrap opera- 
tion. For this device, the drive number is not relevant, since the boot- 
strap operation is always from drive 0. 


DEVICE -ADDRESS PARAMETER % 

The device -address parameter (DEVADD) specifies the peripheral control unit (pcu) ad- 
dress and drive number to be assigned for this File statement. This parameter is required if 
the File statement is present. This parameter has the following format. 


DEVADD = (pcu, drive). 


pcu - Address of peripheral control unit, written as two octal characters. 
The value of the leftmost bit is insignificant. 

drive - Drive number, written as one octal character. This parameter is not 
significant for the bootstrap device (functional-name is BOOT) and can 
be omitted. 


OPERATING PROCEDURES FOR BOOTSTRAP GENERATOR C 

Preparing the Volume for Bootstrap Generation 

In order to generate the bootstrap routine, the mass storage volume must have been pre- 
pared by the Volume Preparation C routine to contain the following information: 

1. Cylinder 0, track 0 formatted with 250-character records; 

2. Volume label; and 

3. Volume directory. 


Loading Bootstrap Generator C 

The procedures for loading Bootstrap Generator C depend on the monitor and the operating 
system being used. Bootstrap Generator C can be loaded using any one of the following monitors. 

1. Mass storage Supervisor. 

2. One of the following loaders in the Series 200/Operating System - Mod 1 
(Tape Resident). 

a. Tape Loader -Monitor C; or 

b. Floating Tape Loader -Monitor C. 

LOADING WITH THE SUPERVISOR 

The statements in the job control file are exactly as described on page 3-3 under the head- 
ing "Job Control Language for Bootstrap Generator C," i. e. , an Execute statement followed 
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by one Supervisor statement and up to two File statements. The Supervisor and File statements 
can appear in any order or can be absent. In any case, the last line of the last job control state- 
ment must contain an E in the mark field. 

The following procedures are used to load with the Supervisor: 

1. Place the job control statement in the card reader; 

2. Obtain the Supervisor "ready state," i.e., the Supervisor is ready to read 
an Execute statement; and 

3. Press RUN (if necessary). 

LOADING WITH A MOD 1 TAPE LOADER -MONITOR 

When loading with a Mod 1 tape loader -monitor, the Execute statement is replaced by a 
console call card. The format of the console call card is shown in Table 3-2. The remainder 
of the job control file is the same as that for the Mod 1 (MSR) Operating System. 


Table 3-2. Format of Console Call Card 


Characters 

Contents 

Meaning 

1 - 8 

*BOOTGEN 

Program and segment names of Bootstrap 
Generator C. 

9 

d 

Tape drive number from which Bootstrap 
Generator C is to be loaded. 

10 - 17 

ppppppss 

The Supervisor halts after the named seg- 
ment is loaded. If left blank, the monitor 
does not halt. 

18 

* 

Asterisk (required by the Mod 1 (TR) 
Operating System). 


The following procedures are used to load with a Mod 1 tape loader -monitor: 

1. Place the job control file in the card reader; 

2. Obtain halt 17002 (monitor ready to read a console call card); 

3. If slow disk transfer rate only is required at generation time, display 
location 63 (77 octal) and replace with an item mark; and 

4. Press RUN. 

OPERATOR CONTROL AND MESSAGES 

At the time of a condition requiring operator action, information is conveyed to the opera- 
tor in the following manner: 

1. Through coded values in the B-address register if the control panel is 
being used; or 

2. Through typed messages if the console is being used. 
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The operator takes corrective action and: 

1. Enters the response character through the control panel if the control 
panel is being used; or 

2. Types the response character at the console keyboard if the console 
is being used. 

Control Panel Halts 

When a halt occurs, the B -address register contains a coded value that indicates the 
reason for the halt. Normally, this is sufficient for the operator to take appropriate action. 

In some cases, the A-address register value supplies supplementary information to the 
operator at the time of the halt. In such cases, the A-address value is the address of a list of 
information. The contents of this list depend on the specific condition and are defined in the 
following paragraphs. 

In the tables below only the rightmost four octal digits (12 bits) of the B -address value are 
shown. The remaining bits are zeros. 

PERIPHERAL DEVICE CONDITIONS 

A B -address register value in the range 0000 to 3777 (inclusive) indicates a condition re- 
lated to a peripheral device operation. The B -address register value has the general form 
ppxd: 

pp = Peripheral control address assignment with the leftmost bit set to zero; 
x = Code indicating the type of peripheral condition; and 
d = Device number (if applicable). 

If the device is mass storage, the A-address register value is the address of a list of in- 
formation in the following order. 

1. Response location - One character. 

2. Specific code - One character, indicating supplementary information 

about the condition. 

3. File name - Ten characters, giving the name of the file being 

processed. 

The operator should determine which peripheral device is referred to by the "pp" and "d" 
values of the B -address register, and then he should consult the following table. 
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Table 3-3. Halts Caused by Peripheral Device Conditions 


B -Address 

Register 

Value 

Specific 

Code 

Condition 

Operator Action 

ppOd 


Device inoperable 
(mass storage only) 

See specific action below. 


01 

Device inoperable 

Cycle up device if necessary. 
Enter G and press RUN to 
continue. 


02 

Protection violation 

Verify that protection switches 
on control are set properly. 
Enter G and press RUN to 
continue. 

ppld 


Uncorrectable read 
error 

See specific action below. 

If pp = 


d = 1 cycle check 

Correct card if possible. 

card 

reader; 


d = 2 validity check 

Refeed cards starting with 
card in error. Press RUN 
to continue. 

pp2d 


Uncorrectable write 
error 

See specific action below. 

If pp = 

04 


Enter G and press RUN to 

mas s 
storage: 

10 

' 

try again. If error persists, 
record specific code and 
terminate run. 

pp4d 

03 

Positioning or 

Enter G and press RUN to 


05 

addressing error 
(mass storage only) 

try again. If error persists, 
record specific code and terminate 
run. 

pp7d 

11 

Miscellaneous 
device error 
condition 

(mass storage only) 



JOB CONTROL FILE CONDITIONS 

A B -address register value in the range 5000 to 5077 indicates a condition related to the job 
control file. The A-address register value is not used when the halt is caused by a job control 
file condition. 


The following table contains the B-address register values, their meanings, and correspond- 
ing operator actions related to job control file conditions. 
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Table 3-4. Job Control File Condition Halts 


B-Address 

Register 

Value 

Meaning 

Operator Action 

5001 

Command code not 
recognized 

Correct the card in error and 
refeed starting with that card. 
Press RUN. 

5003 

Keyword not 
recognized 

5005 

Illegal value for 
keyword parameter 


BOOTSTRAP GENERATOR C END-OF-RUN 

A B-address register value of 6520 indicates that the bootstrap routine has been written 
on the mass storage device. This halt is necessary because Bootstrap Generator C may be run 
as a self-loading card deck, in which case a loader halt, signifying end-of-run, is not available. 
The following table gives the meaning and operator action for the 6520 halt. 


Table 3-5. Bootstrap Generator C End-of-Run 


B -Address 

Register 

Value 

Meaning 

Operator Action 

6520 

End-of-run 

If operating under a resident 
monitor, press RUN to get to a 
'ready state (or 17002 halt). 


Console Messages 

When a console message indicates an error or requests operator action, the operator 
performs the following steps: 

1. He reads the typeout. (To repeat the message, he presses the space 
bar twice.) If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1 -character response (G, E, etc.). 

4. If the typein is correct, he presses the space bar to continue. 

If it is incorrect, he types any other character and returns to step 3. 


PERIPHERAL DEVICE CONDITIONS 

When the first line of a message typed on the console is of the form 
pp d message 
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then the condition causing the message is related to peripheral device operation. 

pp = Address assignment of peripheral control (with the leftmost 
bit set to zero); 

d = Device number (if applicable). 

If the device is mass storage a second message line is typed. This line is a list of in- 
formation, in the following order: 

Specific code - One character, indicating supplementary information 
about the condition and 

File name - Ten characters, giving the name of the file being 
processed. 

The operator should determine which peripheral device is referred to by the "pp" and "d " 
portions of the message; then Table 3-6 should be consulted to determine appropriate action. 


The operator must enter a response character (i.e. , type in a character when the TYPE 
light goes on). 


Table 3-6. Peripheral Device Condition Messages 


Typewriter Message 

Specific 

Code 

(alphanumeric) 

Condition 

Operator Action 

pp d INOPERABLE 


Device inoperable 
(mass storage only) 

See specific action below. 


1 

Device inoperable 

Cycle up device, if necessary. 
Enter G to continue. 


2 

Protection viola- 
tion 

Verify that protection switches 
on control are set properly. 
Enter G to continue. 

pp d READ ERROR 


Uncorrectable read 
error 

See specific action below. 



d = 1 cycle check 

Correct card, if possible. Re- 
feed cards, starting with card 
in error. 



d = 2 validity check 

Enter G to continue. 

pp d WRITE ERROR 


Uncorrectable 
write error 

See specific action below. 


4 

8 


Enter G to try again. If error 
persists, record specific code 
and terminate run. 
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Table 3-6 (cont). Peripheral Device Condition Messages 


Typewriter Message 

Specific 

Code 

(alphanumeric) 

Condition 

Operator Action 

pp d POSITIONING 
ERROR 

3 

5 

Positioning or 
addressing error 
(mass storage only) 

Enter G to try again. If error 
persists, record specific code 
and terminate run. 

pp d 

MISCELLANEOUS 

9 

Miscellaneous de- 
vice error condition 
(mass storage only) 


JOB CONTROL FILE CONDITIONS 

When the line typed out is of the form, 

JOB CONTROL FILE ERROR, message 

then the condition demanding a response is related to the job control file. No second line is 
typed. 


The diagnostic messages are listed in Table 3-7. 


Table 3-7. Messages for Job Control File Conditions 


Typewriter Message 

Meaning 

Operator Action 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Command code not recognized. 

Correct the card in 
error and refeed 
starting with that 
card. 

Enter G to continue. 

JOB CONTROL FILE ERROR, 
KEYWORD PARAMETER 

Keyword not recognized. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Illegal value for keyword 
parameter. 


BOOTSTRAP GENERATOR C END-OF-RUN 

Table 3-8 contains the typewriter message, which indicates that the bootstrap routine 
has been written on the mass storage device. Operator action is necessary because Bootstrap 
Generator C may be run as a self-loading card deck, in which case there is no resident loader to 
return to. 


Table 3-8. Bootstrap Generator C End-of-Run Message 


Typewriter Message 

Meaning 

Operator Action 

END JOB 

End-of-run 

If operating under a resident 
monitor, enter G to get to 
a ready state. 
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SECTION IV 

MASS STORAGE SORT C 


INTRODUCTION TO MASS STORAGE SORT C 

Mass Storage Sort C (herein after referred to as the sort) is a utility routine of the Series 
200/Operating System - Mod 1 (Mass Storage Resident). It is highly flexible, enabling it to meet 
a wide variety of user requirements. It may be operated as a key sort, an extract sort, or an 
item sort. Accompanying the sort are two routines which facilitate the processing of the sorted 
output. These two routines are: the Fetch macro routine (similar to an input/output macro 
routine) and the sequential output file program. The relationship between the sorting process 
and these two output processes is discussed below. 

A key sort takes the sort-key fields from the input item (source item) and attaches the 
mass storage address of the item to the key. It then processes only this condensed data, 
which saves considerable time if the key is a small percentage of the total item and the file is 
fairly large. The sort output (sort- item file) is an ordered collection (via chaining) of the keys 
with the appended addresses of the associated items. The user may write a program incor- 
porating the Fetch macro statement and process the output of the sort. The Fetch routine re- 
trieves certain elements of the sorted output sequence as follows: first, the sort item contain- 
ing the key and the source-item address, and second, the associated mass storage resident 
source item. Similarly, the sequential output file program can be used to create a sequential 
file (as defined in the Data Management Subsystem manual) of the source items in the sorted 
output sequence. 

An extract sort is similar to a key sort except that selected fields are extracted from the 
source item and carried through the sort process with the key. If the application is concerned 
only with selected fields of the source item, considerable time can be saved during the extract 
option. For example, if a file is being sorted in preparation for producing a report and if the 
key, plus the fields required for the report, are a small part of the full source item, an extract 
sort can be highly efficient. The user may access the key and the extracted fields in the sort 
output sequence either with own-coding during the final merge portion of the sort or with the 
Fetch routine in a program of his own. In either case, there is no need to reaccess the source 
items. The sequential output file program can be used to create a sequential file of sort items. 
(Each item in the file is made up of fields of the corresponding source item. ) 
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An item, sort is essentially an extract sort where the entire source item is extracted. In 
the sort, the item sort option produces a sort item (prior to the Fetch operation) which is in the 

same form as the source item. (In the case of the key sort or the extract sort, the sort item 
is in the rearranged form shown in Figure 4-12.) 


Figure 4-1 illustrates the relationship between the sorting process and the output pro- 
cesses. Note that the sort -item file is always input to the output processes. The source-item 
file is input only if access to the source items is required. 


SORT PROCESS 


USER 




OUTPUT PROCESS 


FETCH 

MACRO 

ROUTINE 


PROGRAM 


MASS STORAGE 
SORT C PRESORT 
AND MERGE 


SOURCE- ITEM 
FILE 

(SORT INPUT FILE- 
MASS STORAGE, 
TAPE, OR CARDS) 


SORT-ITEM FILE 
(WORK FILE) 



SEQUENTIAL 

OUTPUT 

FILE 

PROGRAM 



USER 

.WRITTEN 

OUTPUT 

FILE 


-CP) 

SEQUENTIAL 
OUTPUT FILE 
(MASS STORAGE 
OR TAPE ) 


Figure 4-1. Relationship Between Sorting Process and Output Processes 


EQUIPMENT REQUIREMENTS FOR MASS STORAGE SORT C 
Basic Equipment Requirements 

The equipment requirements for Mass Storage Sort C are listed below: 
A Series 200 central processor; 

Advanced Programming Instructions; 

12, 288 characters of main memory; and 
One disk device and associated control. 
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This combination may be any one of the following: 


Device Type 

Control Type 

155 

157C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

259A 

25 7A 

259B 

25 7B 

261 

260 

262 

260 


One card reader (unless sort parameters are resident in memory) is also required. 

Additional Usable Equipment 

The following additional equipment also may be used: 

One printer; 

One or more 1 /2-inch Type 204B Magnetic Tape Units; 

One Type 220-1 or -3 Console (console I/O requires 4,096 additional char- 
acters of main memory); 

Up to a total of 32, 768 characters of main memory; 

Second I/O Sector (Feature 1115 for Model 2200); and 
One or more additional disk devices as tabulated above. 


SUMMARY OF MASS STORAGE SORT C CAPABILITIES 


The following list summarizes capabilities of the sort. 

1. Sorts fixed-length items. 

2. Sorts according to sort -key fields up to a maximum of ten in ascending, 
descending, or mixed sequence. 

3. Allows up to 1 1 extract fields or residue of an item to be an element of 
the sort item. 


4. Allows translation which permits the sorted order to be based upon the 
commercial collating sequence. 

5. Permits the selection of only those items for the sort that have a field 
that bears a relationship to a specified value. 

6. Permits deletion from the sort of those items that have a field that bears 
a relationship to a specified value. 

7. Allows user's own-coding on an input item-by-item basis. 

8. Allows user's own-coding on an output sort item-by-item basis. 

9. Accepts input from a mass storage device, magnetic tape, cards, or 
through own- coding only. 

10. Can process sequential, direct access, and indexed- sequential mass 
storage files. 


11 . 

1/5/70 


Provides output in a work-file area on the mass storage device. 
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12. Allows the user to restrict the scSrt-item block size. 

13. If requested, it ensures that the work area defined by the user is sufficient 
for the successful completion of the sort. 

14. Permits the user to receive the results of sort-item block and work-area 
calculations prior to and apart from sort execution. 

15. Preserves the original input file. 

16. If requested, it creates a sequential file on mass storage or a file on 1/2- 
inch magnetic tape. 

FUNCTIONAL DESCRIPTION OF MASS STORAGE SORT C 
Definition of Terms 

The following terms are used frequently in this section and are hereby defined for the 
reader. 

1. Sort keys — those fields of an item that determine the order of the sort 
output and are part of the sort output. 

2. Extract fields — those fields of an item that may be selected to be part of 
the sort output. Extract and sort-key fields must be distinct. 

3. Sort item — the internal item of the sort that has been derived from a 
source item. It will contain sort-key fields and may contain extract fields 
and a source-item address. 

4. Residue — that data of an item that is not contained in a sort-key field. 

5. Fetch — a macro routine that simplifies the processing of the sort item 
file as well as the input file from which the sort file was generated unless 
that file was on card or tape. The Fetch macro routine is described in 
detail on page 4-6. 

Function of Program 

The sort processes a file stored on either a mass storage device, a 1 /2-inch magnetic 
tape, or punched cards. It also processes items entered through own-coding only. A mass 
storage file that is to be input to the sort must conform to the Mod 1 (MSR ) data management con- 
ventions for either a sequential, direct access, or an indexed sequential file. Input from cards 
and 1 /2-inch magnetic tape are discussed on page 4-8. 

From each item that is a valid entry to the sort, a sort item is developed which contains 
the sort-key fields as a unit. The address of the mass storage resident source item may be 
appended to the sort-key unit, and the extract or residue may be prefixed to that same unit. 

The sort produces one string or file of logically sequenced sort items in a work area. 
Ordering in the logical sequence is a function of the Honeywell collating sequence (binary 000000 
to 111111) as well as the sort-key fields. A request for translation causes the sorted order to be 
based on the commercial collating sequence. A user requiring some other collating sequence is 
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able to achieve it through own-coding. At the completion of the sort process, the sort items may 
then be made available to the user through a specialized Fetch macro routine which may retrieve 
an associated mass storage resident source item. 

If the user desires, the output from the sort may be a sequential file, organized according 
to the data management conventions, or it may be a file on 1 /2-inch magnetic tape. Refer to 
"Sequential Output File Program Input/Output Files, " in this section. 

Function of Segments 

The sort may be considered as consisting of two logical segments: presort and merge. 
PRESORT SEGMENT 

The presort segment develops a sort item from each item that is acceptable to the parti- 
cular application. These sort items are arranged into ordered strings whose length is deter- 
mined by the available memory and the requirement that an efficient covering is made of the 
available cylinder area. 

Own-coding can be entered during the presort, thus permitting the inspection, modification, 
deletion, and addition of items. 

MERGE SEGMENT 

The merge segment is subdivided into two phases, "1 -cylinder, " and "multicylinder. " 

The 1 -cylinder phase merges the strings that exist on one cylinder until they are reduced 
to a single string of sort items. Memory available to the 1 -cylinder phase is a factor in deter- 
mining the "way" of the merge. 

The multicylinder phase merges two cylinders until a final string is produced. A sliding 
buffer technique is employed to ensure the best activity on a cylinder once it has been accessed. 
This phase utilizes the available memory by creating as many buffers as it can. When the final 
string is being created, any required reorganization of the sort item is accomplished. If merge 
own-coding is requested, it becomes active during this final phase and permits access to the sort 
item after it has been reorganized. 

If the type of output requested from the sort is in the form of either a sequential file or a 
file on 1 /2-inch magnetic tape, the multicylinder phase calls the sequential output file program 
(see page 4-9 ). 
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FUNCTIONAL DESCRIPTIONS OF OUTPUT PROCESSES 

Functional Description of Fetch Macro Routine 

The Fetch macro routine simplifies the processing of the Mass Storage Sort C sort-item 
file as well as the mass storage resident source-item file from which the sort-item file was 
generated. It makes available the sort item and its associated source item on an item-by-item 
basis. Hence, the items of the mass storage resident source-item file can be processed in the 
logical sequence promoted by the sort application. The user may exercise options that restrict 
his access to either the sort items or to the mass storage resident source items. 

SPECIALIZATION OF FETCH MACRO ROUTINE 

Partial specialization of the Fetch macro routine is achieved principally by assigning 
values to the parameters of the Fetch macro statement. However, certain parameters required 
for full specialization can be ascertained only after the sort has produced its sort-item file. The 
values for these parameters are written by the sort on a mass storage device. When the pro- 
gram containing the partially specialized version of Fetch is executed, the block containing these 
values is accessed by Fetch and the final specialization is achieved. A user may modify this 
final version by requesting an exit before any file processing begins. 

A detailed description of the Fetch macro routine is dicussed under "Language Elements of 
Fetch Macro Routine, " in this section. 

Functional Description of Sequential Output File Program 

The sequential output file program processes the Mass Storage Sort C sort-item file and, 
when necessary, the mass storage resident file that was input to the sort (source file). It creates 
either a sequential file on mass storage or a file on 1 /2-inch magnetic tape containing the items 
in the sequence produced by the particular sort application. 

A detailed description of the sequential output file program is discussed under "Job Control 
Language for Sequential Output File Program, " in this section. 

When the request for a sequential output file or a tape file is made by the inclusion of an 
output file statement in the sort job control file, the sort creates an additional parameter record 
in the sort work file. The contents of this parameter record are made available to the sequential 
output file program when it is called by the sort. 

When the sequential output file program is called through a separate Execute statement, the 
parameter information must be submitted to the sequential output file program through a separate 
set of job control statements. 
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The sequential output file program consists of two types of processing. 

SORT-ITEM FILE TO SEQUENTIAL FILE 

This process is called if in the preceding sort application no source-item address was 
appended to the sort item, or an item sort was executed. The assumption is that the sequential 
file or tape file to be created will have an item that corresponds to the sort item as it exists in 
the sort-item file created by the sort. (When an item sort is requested, the sort item is the 
complete source item. ) 

When item own-coding is specified, the sort item is made available to the user before it 
is transferred to item storage. The item may be deleted or modified. Alternatively, an item 
having the same characteristics as the sort item may be added. 

SOURCE-ITEM FILE TO SEQUENTIAL FILE 

This process is called if the sort item has a mass storage source-item address appended 
to it. It is assumed that the items to be placed in the output file are to be obtained from a mass 
storage resident source file (original input file). 

When item own-coding is specified, the sort item is made available to the user. Note that 
the sort item is determined by the values given to the key and extract parameters of the sort. 

The user may now delete an item, based upon the contents of the sort item, or an item having 
the same characteristics as the source items may be added for inclusion in the output file. 

FUNCTIONAL DESCRIPTION OF INPUT /OUTPUT FILES 

Normally, a sort is run to produce a sorted sequence of keys, extracts, or items. The 
sort-item file is then processed either by a program containing a specialized Fetch macro rou- 
tine and user coding or by the sequential output file program. The latter may be called through 
a separate Execute statement, or it may be called directly by the sort through the use of an out- 
put file statement in the job control file. In either case, the sort-item file is the input to the 
Fetch macro routine or to the sequential output file program. 

Sort Input /Output Files 

The input file (source file) to the sort may reside either on a mass storage device, on 1/2- 
inch magnetic tape, or on punched cards. In addition, all items to be sorted may be entered 
through own-coding. 

A mass-storage-resident source file may be any file organization (except partitioned se- 
quential) that conforms to the Mod 1 (MSR) data management conventions. 
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A file on 1 /2-inch magnetic tape that is to be processed by the sort must contain data 
records consisting only of fixed-length items. Also, the file must conform to one of the follow- 
ing tape file formats: 

1. Bannerless, standard labels in odd or even parity: 

2. Bannerless, no labels in odd or even parity; 

3. Bannered, standard labels in odd or even parity; and 

4. Bannered, no labels in odd or even parity. 

In the case of standard labels, all headers are treated as if they are regular and not extended; 
therefore, information in character positions 41-80 in the header label is disregarded. Tape 
marks may occur following the header and/or preceding a standard trailer. The presence of 
these tape marks on the input tape is recorded if a request is made for tape output through the 
sort job control file. Tape input files may be multireel, and data records may be blocked or un- 
blocked. 

Card input to the sort may be read in standard or in special mode. The first card in the 
input deck should contain the first item, or part of the first item. When the item exceeds 80 
characters, it must exist on consecutive cards. The first character of an item must start in 
column 1 of the card. For example, consider an item 120 characters in length as shown in 
Figure 4-2. 



Figure 4-2. Card Input File 


Note that Figure 4-2 shows that the last item must be followed by a card containing 1EOFA in 
columns 1-5. All input may be through own-coding as described under "Own-Coding- Only Source 
of Input to the Sort, " in this section. 
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The output from the sort (sort-item file) is an aggregate of chained blocks containing sort 
items in the sorted sequence. This sort-item file uses the area specified to the sort as the work 
files. However, because the structure of this file does not conform to the mass storage data 
management conventions, it should be processed by either the Fetch macro routine or the se- 
quential output file program. Figure 4-1 illustrates the relationship between the sorting process 
and the output processes. The format of the sort items for each type of sort (key, extract, or 
item) is shown in Figure 4-12. 

Fetch Macro Source-Item/Sort-Item Files 

The sort-item file is always an input file to the program containing the Fetch macro rou- 
tine (see Figure 4-1). This file is used to access the data of the sort application in the sorted 
sequence. If the application is an extract sort or an item sort, then only this file is needed as 
input to the Fetch macro routine. 

If the source file is mass storage resident and the application requires access to the origi- 
nal input file (as is necessary in a pure key sort), the source item is also an input to the Fetch 
macro routine. Items in this file are accessed "directly" in the sorted sequence, as directed by 
the items in the sort-item file. 

If the user desires, he may create a file containing sort items by using the program con- 
taining the Fetch macro routine. This process is entirely under user control. 

Sequential Output File Program Input/Output Files 

The sort-item file is always one input file to the sequential output file program, as it is 
for the Fetch macro routine. If no source-item address is appended to the sort item, the se- 
quential output file program cannot access the source file. The sort item becomes the final out- 
put item. 

If a source-item address is appended to the sort item, the source file resides on a mass 
storage device and is a second input file to the sequential output file program. The source item 
becomes the final output item. 

The sort-ordered output file from the sequential output file program may be either a se- 
quential file on a mass storage device or a file on 1 /2-inch magnetic tape. 

When the output file request is made at sort execution time, the creation of the output file 
may be regarded as a process executed by a logical segment of the sort. If this is the case, and 
the input to the sort is 1 /2-inch magnetic tape, the format of the output tape is the same as that 
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of the input tape, with the exception that the size of the data record may be changed. Tape marks 
present on the input tape appear on the output tape. Input tape labels are updated and used as 
output labels. If the input to the sort comes from a medium other than magnetic tape and tape 
output is requested, the format of the output tape is bannered, standard labels in odd parity. A 
dummy header and trailer are created. 

When tape output is requested through the job control file for the sequential output file pro- 
gram, the following file formats may be created: 

1. Bannerless, standard labels in odd or even parity; 

2. Bannerless, no labels in odd or even parity; 

3. Bannered, standard labels in odd or even parity; and 

4. Bannered, no labels in odd or even parity. 


If the tape input to the preceding sort has standard labels and standard labels are requested 
on the output tape, the input labels are updated and used as the output labels. If the input to the 
sort comes from some medium o + her than tape or from a tape with no labels, and tape output with 
standard labels is requested, dummy labels are created by the sequential output file program. 


Table 4-1 summarizes the various tape output file formats created by the sequential out- 
put file program. 


Table 4-1. Tape Output File Formats Created by 
Sequential Output File Program 


^'"' v -v > Output 

Input 

Sequential Output File Pro- 
gram - Called for Execution 
by the Sort 

Sequential Output File Pro- 
gram - Called by an Execute 
Card (LABELS=YES, ) 

Sequential Output File Program - 
Called by an Execute Card 
(LABELS=NO, ) 

Tape Input 
(LABELS^ YES, ) 

1. Input labels updated and used 
as output labels. 

2. Format of output tape same 
as input tape with regard to 
TM, BAN, PAD, PAR. 

3. Size of output data record 
must be specified in job 
control file. 

4. File name is changed only if 
specified in sort job control 
file. 

5. Input retention cycle pre- 
served. 

1. Input labels updated and used 
as output labels. 

2. Format of output tape (TM, 
BAN, PAD, PAR) specified 
through job control file. 

3. File name and record inde- 
pendent of input file (speci- 
fied through job control file). 

4. Input retention cycle pre- 
served. 

1. No labels. 

2. Format of output tape [(TM), 
BAN, PAD, PAR] specified 
through job control file. 

3. TM automatically placed 
after data. 

4. Output record size specified 
through job control file. 

Tape Input 

(LABELS=NO, ) 

1. No labels. 

2. Format of output tape same 
as input tape with regard to 
TM, BAN, PAD, PAR. TM 
automatically placed after 
data. 

3. Size of output data record 
must be specified in sort 
job control file. 

1. Create dummy header and 
trailer. 

2. Format of output tape (TM, 
BAN, PAD, PAR) specified 
through job control file. 

3. File name and record size 
independent of input file 
(specified through job con- 
trol file). 

4. Retention cycle 0. 

Same as above. 

Other Input 

Disk Cards Own- 

Coding Only 
* 

1. Create dummy header and 
trailer. 

2. Format of output tape is ban- 
nered, odd parity and padding 
of 778. The banner is 56 q. 

No tape marks appear. 

Same as above. 

Same as above.. 
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JOB CONTROL LANGUAGE FOR MASS STORAGE SORT C 
Requesting Sort Operation 

The specification of the parameters to the sort may be made through statements in the job 
control file, or the parameters may be resident in main memory when the sort is called. (The 
job control file must be in the card reader. For a job control file in a card reader, the term 
"line" denotes one card. ) 

The two possible Execute statements are described under "Loading and Executing, " in this 
section. 

Job Control Statements and Parameters 

A variable number of job control statements is required to define the sort parameters, 
depending on the demands of a particular application. 

OPTIONAL PARAMETERS 

Optional parameters have an assumed or "default" value. When such a parameter is 
omitted in the job control statements, the default value is used. 

PARAMETER SET 

The collection of statements required for a sort operation is called the parameter set. 

An E in the mark field of a line indicates that this is the last line of the set. The line containing 
the E may be the same line as the last line containing a parameter, or it may be a separate line 
containing no parameters . 

ORDER OF STATEMENTS 

Statements may be in any order in the job control file. The first line of a statement must 
have a nonblank operation code field. 

All device address parameters (for multivolume files) should be written on a single line to 
reduce difficulties if card decks are disarranged. 

NUMERIC VALUES 

Numeric values in parameters are always decimal (unless otherwise noted), and leading 
zeros may be omitted. 

Sort Statement 

A Sort statement is required in the job control file; the format of this statement is shown 
in Figure 4-3. 
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HIGH-MEMORY-ADDRESS PARAMETER 

The high-memory-address parameter (HMA) defines the highest memory address available 
to the sort. However, if an own-code program is resident during a phase of the sort and the 
base address of that program is lower than that specified by the HMA parameter, then the base 
address of that program less one is the highest memory address available to that phase. This 
parameter takes the following form. 


HMA = { hi £ addrCSS I , 

( nnM ) 

high-address - The highest address available, written as a decimal number (up 
to six characters in length). 

nnM - The number of memory modules (M) available, written as a 2- 

character decimal number. The highest address available is 
computed by the sort and is one location less than nn times 
4, 096. M is a parameter constant. 


The default assumption is that the HMA value is to be taken from the Supervisor communi- 
cation area field that specifies the highest address available to the object program memory. If 
HMA is specified but has a higher address than the address in the Supervisor, the Supervisor 
value is used. 
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Figure 4-3. Sort Statement and Parameters 


SEQUENCE PARAMETER 

The sequence parameter (SEQ) describes the primary sorting sequence. The form of the 
parameter is as follows. 

seq "{d}- 
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A - Ascending sequence. 

D - Descending sequence. 

The default assumption is ascending sequence. 

ITEM-ADDRESS PARAMETER 

The item-address parameter (ITADD) indicates whether or not the mass storage address 
of the item is to be appended to the sort item. The form of this parameter is as follows. 



NO - The item address is not to be appended. 

YES - The item address is to be appended. 

The use of the item-address parameter when input is from cards or tape is meaningless; 
the default assumption for these two input media is NO. If the input is from mass storage or 
through own-coding, the default assumption is YES. Use YES if the application requires ac- 
cessing of the input file after completion of the sort (refer to "Detailed Description of Fetch 
Macro Routine" and to "Detailed Description of Sequential Output File Program in this section). 

TRANSLATION PARAMETER 

The translation parameter (TRANS) indicates the sort order; it is to be in either Honeywell 
collating sequence (binary 000000 to 111111) or commercial collating sequence. 



NO - Translation is not required, and the Honeywell collating sequence is to 
be used. 

YES - Translation is required, and the commercial collating sequence is to 
be used. 

The default assumption is NO. 

PRECALCULATION PARAMETER 

The precalculation parameter (PRECAL) indicates whether the sort is to be executed after 
the calculation of the sort-item block size and, if requested, the determination that sufficient 
work area has been allocated. 



NO - The sort is to be executed. 

YES - The sort program is to return to the Supervisor after completing the re- 
quested calculation. 
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The default assumption is that the sort is to be executed. When the parameter value is 
YES, the sort indicates the results of the calculations through the printer, if available, or, if 
the printer is not available, through the operator control file. 

VOLUME OF INPUT PARAMETER 

This parameter (INVOL) indicates to the sort that, prior to execution, a check is to be 
made to ensure that the work area defined by the specification of work files is sufficient for the 
successful execution of the sort. 

j INVOL = number-of-items, 

number -of-items - The number of items to be processed by the sort (six deci- 
mal characters). Leading zeros not required. 

The default assumption is that the size of the work area is not checked. 

SORT-ITEM BLOCK RESTRICTION PARAMETER 

The sort-item block restriction parameter (SIB) indicates that the user wishes to control 
the maximum size of the sort-item block. 

J^SIB^=^umber-oLrecord^^ 

number-of-records - The maximum number of 250-character physical records 

that the sort may use to contain the sort item block (a 
2-character decimal number). 

The default assumption is that the sort can freely determine the size of its sort-item block. 

File Statements 

The File statements specify information about the input and output files used by the sort. 
The input/output function name, which is the first parameter of each File statement, specifies 
to which file the statement refers. The File statements are of four types: 

1. Input (source-item) file; 

2. Work file; 

3. Output file; and 

4. Information file. 

Each type of File statement is described below under a separate heading. 

INPUT FILE 

The input file is the file of input data to the sort. The parameter "IN" identifies a File 
statement as referring to the input file (see Figure 4-4). The File statement for the input file 
must be present; there is no default assumption. 
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Figure 4-4. File Statement and Parameters for Input File 


Name Parameter 

The name parameter (NAME) specifies the file name of the input file to the sort. The 
form of this parameter is shown below: 

NAME = file -name, 

file -name - The file name of the input file (up to ten characters in length). Trail- 
ing spaces are added. 

For mass storage, the file name is required and is the name of the input file. For tape 
input, it is optional, and if specified, the file name of the input file will be checked against the 
value of the parameter (the default assumption is not to check the input file name). For card 
input and own-coding only, specifying this parameter has no meaning and is ignored. 

Device-Type Parameter 

The device-type parameter (DEVTYPE) specifies the storage medium used for the file as 
well as the type of peripheral device used to access the file. It may also be used to indicate that 
all input to the sort is to be fed through own-coding. 

| DEVTYP E = de vice-type, 

device -type - The type number of the device used to access the file, or the com- 
mon name of that device. 
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The device type may be chosen from the following list: 

227 214-2 

223 204B 

224-1 NONE 

224-2 

or if the common name is used: 

CARD 

TAPE 

The parameter value must be NONE when all items to the sort are to be entered through 
own-coding. 

The default assumption is mass storage. (Device type codes for mass storage are not 
used in the mass storage sort.) 

Device- Address Parameter 

This parameter (DEVADD) takes the following form. 

•j DEVADD = (pcu<, drive >) ,j> ... 

pcu - The peripheral address assignment of the control unit (two octal charac- 
ters). Except for card input, the I/O bit is irrelevant but all other bits 
must be specified. If input is from cards, all six bits must be specified. 

drive - Drive number (one octal character). 

For mass storage, the device-address parameter specifies the physical device address(es) 
of the volume(s) containing the source item file. An input file may be contained on up to a maxi- 
mum of eight volumes. 

The default assumption is pcu 04, drive 0, and the file is contained on a single volume. 

If the item address is appended, all volumes of the input file must be mounted on line and 
must, therefore, be specified in this parameter. If, however, the item address is not to be 
appended, the input file may be mounted on the minimum number of disk drives acceptable to its 
file organization. The sort will cycle through the device address assignments. 

For tape, the default assumption is pcu 00, drive 1. Up to two devices may be specified, 
but the same pcu must be specified for both. For cards, the default assumption is 41. This pa- 
rameter has no meaning for own-coding only. 

For each device address being specified, DEVADD is necessary. 
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Password Parameter 

The password parameter (PW) defines the password of the mass storage source-item file. 
The form of this parameter is shown below. 

PW = password, 

password - The source-item file password (up to eight characters in length). 

Trailing spaces are added. 

The default assumption is that the file is not protected by a password. 

Item Parameter 

The item parameter (ITEM) specifies the number of characters in an item. 

ITEM = length-of-item, 

length-of-item - The size of the item in terms of the number of characters (up 
to four decimal characters). 

This parameter is ignored if the input to the sort resides on mass storage. This parameter 
is required for all other input. 

Record-Length Parameter 

The record-length parameter (REC) specifies the number of characters in a record. 

^REC^^^record^length^ 

record-length - The number of characters in each record (up to four decimal 

characters). This includes a banner character when applicable. 

This parameter is only significant if the input file is on tape. It should be omitted if the 
input to the sort comes from any other source. 

Banner Parameter 

This parameter (BAN) specifies whether or not the file is bannered and applies only to an 
input file on tape. 



NO - The file is unbannered. 
YES - The file is bannered. 

The default value is YES. 
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Padding Character Parameter 

This parameter (PAD) specifies a padding character for a magnetic tape file. 

| PAD = padding, 

padding - The padding character expressed as two octal digits. 

For a file with odd parity, the default value is octal 77; for a file with even parity, the de- 
fault value is octal 11. If the first three characters of an item on tape are equal to the padding 
character, the item is bypassed. 

Parity Parameter 

This parameter (PAR) specifies the recording parity for a magnetic tape. 



ODD - Odd parity. 

EVEN - Even parity. 

The default value is ODD. 

Label Parameter 

Magnetic tape files may have standard labels or no labels. 



NO - The file has no labels and is terminated’by a tape mark. 

YES - The file has standard labels. 

The default assumption is standard labels. 

Reels Parameter 

A magnetic tape file may be contained on more than one reel. This parameter (REELS) is 
required if there are no labels on a multivolume tape file. 

|^^EELS^^iumber^-of-reels^^ 

number -of -reels - The number of reels of the file expressed as a single decimal 
digit. 

The default assumption is a single reel. This parameter is ignored if the file has standard 
labels. 
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Mode Parameter 

The mode parameter (MODE) specifies the card reading mode for a punched card file. 

MODE = { | , 

l SPEC j ’ 

STAND - The standard card mode. 

SPEC - The special card mode. 

The default value is special. 

WORK FILES 

The sort requires a work area in which it can create a sort item file on mass storage. 
This work area is assigned to the sort as one or more files. Normally, one file is sufficient 
for the work area. However, in some cases, one work file is not large enough to handle the 
sorting requirements. Therefore, up to five work files may be assigned. These files are re- 
ferred to as work file 1, work file 2, etc. The parameter work n (where n is 1, 2, etc.) iden- 
tifies the work file being referred to (see Figure 4-5). 

If no File statement for work file 1 appears, the default assumption is that there is a work 
file named "*SORTWORK" on pcu 04, drive 0. The total number of units of allocation for all 
work files cannot exceed five. 
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Figure 4-5. File Statement and Parameters for Work File 


Name Parameter 

The name parameter (NAME) specifies the name given to this work file. The form of this 
parameter is as follows. 

| NAME = file -name, 

file -name - The file name of the work file (up to ten characters in length). Trailing 
spaces are added. 

The default assumption is *SORTW ORKA . 
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Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical device address(es) of the 
volume(s) containing the work file. The form of this parameter is shown below. 

| DEVADD = (pcu, drive), 

pcu - The peripheral address assignment of the control unit (two octal characters). 

The high-order bit is irrelevant, but all other bits must be specified. 

drive - The drive number. 

The default assumption is pcu 04, drive 0, and the work file is contained on a single volume. 

The total number of volumes that may be specified for all files is five, since the work area 
that can be utilized by the sort cannot exceed five units of allocation. 

For each device address being specified, DEVADD is necessary. 



OUTPUT FILE 

If the File statement for the output file is present (see Figure 4-6), a request is made for 
the creation of a sort-ordered file either in a sequential file organization or on a 1 /2-inch mag- 
netic tape. At the completion of the sorting process, the sequential file program is executed. 


The default assumption is that neither sequential file output nor tape output is required. 
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Figure 4-6. File Statement and Parameters for Output File 
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Name Parameter 

The name parameter (NAME) specifies the name of the sequential or tape output file. The 
form of the parameter is shown below. 

NAME = file-name, 

file-name - The name of the output file (up to ten alphanumeric characters). 


For mass storage, a name must be specified for the sequential output file. 

NOTE: It must be remembered that this file must be allocated prior to the exe- 
cution of the sort. 


If the file is on tape and it is to have standard labels, the value of the name parameter is 
the name given to the output file. 

If the input to the sort was a tape file with standard labels, the default assumption is that 
no name change is required. If the input to the sort was from some other source, the default 
assumption is blanks. 


Device-Type Parameter 

The device-type parameter (DEVTYPE) specifies the storage medium to be used for the 
output file. 

j DEVTYPE = device -type, 

device -type - The type number of the device used for the storing of the output 
file, or the common name of that device. The device type may 
be: 204B or TAPE. 


The default assumption is mass storage (device-type codes for mass storage are not used). 


Device-Address Parameter 

The form of the device-address parameter (DEVADD) is shown below. 

|dEVADD = (pcu, drive), 1 . . . 

pcu - The peripheral address assignment of the control unit (two octal charac- 
ters). The high-order (I/O) bit is irrelevant, but all other bits must be 
specified. 

drive - Drive number (one octal character). 


4-21 


#3-619 




SECTION IV. MASS STORAGE SORT C 


For mass storage, the device-address parameter(s) specifies the physical device ad- 
dresses) of the volume(s) containing the output file. The output file may be contained on more 
than one volume, up to a maximum of eight. The default assumption is pcu 04, drive 0, and the 
file is contained on one volume. 

For tape, up to two devices may be specified; however, the same pcu must be specified 
for both. The default assumption is pcu 00, drive 1. 

For each address being specified, DEVADD is necessary. 

Password Parameter 

The password parameter (PW) defines the password of the mass storage sequential output 
file. This parameter takes the following form. 

PW = password, 

password - The sequential output file password (up to eight characters in length). 

Trailing spaces are added. 

The default assumption is that the file is not protected by a password. 

Record-Length Parameter 

The record-length parameter (REC) indicates the number of characters in each record of 
the output file. 

REC = record-length, 

record-length - The number of characters in each record of the output file (up to 
four decimal characters). This includes the banner character 
when necessary. 

This parameter is significant only if the output file is to be created on tape; in which case, 
it is required. 

INFORMATION FILE 

The information file is a printed program history. The parameter "INFO" identifies a 
File statement as referring to the information file (see Figure 4-7). 

If no File statement for the information file appears, the default assumption is that no pro- 
gram history is required. 
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Figure 4-7. File Statement and Parameters for Information File 


Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical device address of the in- 
formation file. The information file must be on a printer. The form of this parameter is as 
follows. 

| DEVADD = (pcu), 

pcu - The peripheral address assignment of the control unit (two octal characters). 

The address must be in the first I/O sector. 

The default assumption is pcu 02. 


Fields Statement 


Parameters belonging to the Fields statement (see Figure 4-8) define the functions of 
various fields of the source item in relation to the sort operation. 
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Figure 4-8. Parameters for the Fields Statement 
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KEYS PARAMETER 

The keys parameter (KEY or KEYS) specifies the sort- key data and is followed by a list. 

Up to ten sort-key fields may be specified. Their order in the list indicates their sort signifi- 
cance. The order is in decreasing importance. Keys are assumed to be sorted in the order 
defined by the primary sequence of the sort, unless a "reverse" key is specified. A reverse key 
will be sorted in the reverse sequence from the primary order. The form of the parameter is 


| KEYS = ( (position, length<,R>) ■ . , ) , 

Up to four decimal digits giving the position of the leftmost (high-order) 
character of the key field in the item. The first character in the item 
is considered to be in position 0001. 

Up to two decimal digits giving the number of characters in the key field. 

If this parameter value is specified, the key with which it is associated 
is a reverse key. (When omitting this value, the comma preceding it is 
also omitted.) 

The above three values (or two, if R is omitted) form a set which may be repeated up to 
nine times. Each set is enclosed in parentheses and separated by commas. Examples are 
shown below. 

1. One key field - KEYS = (15, 4), (Note that with one key, only one pair of 
parentheses is needed. ) 

2. Three key fields with the second reverse sequence - KEYS = ( (15, 4), (20, 

5, R), (9, 1)),. 

EXTRACT PARAMETER 

The extract (EXTR) parameter specifies extract field information. Extract fields are 
fields of a source item that may be included in the sort item but have no significance in deter- 
mining the final sort order. Up to 1 1 extract fields may be specified, and the order in the list 
determines their relative positions in the sort item. 

When the user wishes the extract fields to be all those fields of the item that have not been 
specified as keys, then the value given to the extract parameter is "ITEM." The specification 
of ITEM implies that the output of the sort will be a string of items in the same format as the 
original source items. Key fields and extract fields must not overlap. The form of this pa- 
rameter is as follows. 

< extr =i;< p ° s ; tion> iength) > • • •>}•> 

(ITEM ) 


shown below. 

position - 

length 

R 
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position - Up to four decimal digits giving the position of the leftmost (high-order) 
character of the extract field in the item. The first character in the 
item is considered to be in position 0001. 

length - Up to two decimal digits giving the number of characters in an extract 
field. 


The default assumption is that no extract fields are required. 


SELECT PARAMETER 

The select parameter (SEL) indicates that the sort application requires that only certain 
items of the input file be acceptable as input to the sort. The value of the select parameter is a 
list of two or three parameters (see format below). The first parameter (position) defines the 
position in the item of the field on which the selection is based. The second parameter (EQ, 

NE, GT, LS, GE, or LE), if specified, is preceded by a keyword (REL). The second parameter 
indicates the standard for selection, that is, equality or the degree of inequality with regard to 
the value specified by the third parameter, which is prefixed by the keyword VAL. This pa- 
rameter defines the contents of the select field. Only one select parameter may be specified. 
The form of this parameter is shown below. 



position - Up to four decimal digits giving the position of the leftmost (high -order) 

character of the field on which the selection is based. The first character 
in the item is considered to be in position 0001. 

EQ - equal 

NE - not equal 

GT - greater than 

LS - less than 

GE - greater than or equal 

LE - less than or equal 

aa. . . a - The value with which the defined field of an input item is to be com- 
pared. The maximum number of characters that the VAL parameter 
can define is 30. Blanks are significant. 


If the second parameter in the list (prefixed by the keyword REL) is not specified, the 
standard for selection of an input item is equality with the value specified by the VAL parameter. 
The default assumption is that the select function is not required. 


DELETE PARAMETER 

The delete parameter (DEL) defines a field that allows an application of the sort to bypass 
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those items which in the designated field bear a relationship to a specified value. The format of 
the delete parameter is the same as for the select parameter and is repeated here for the con- 
venience of the reader. Only one delete parameter can be specified. 



position - Up to four decimal digits giving the position of the leftmost (high-order) 
character of the field on which the deletion is based. The first character 
in the item is considered to be in position 0001. 

EQ - equal 

NE - not equal 

GT - greater than 

LS - less than 

GE - greater than or equal 

LE - less than or equal 

aa. . . a - The value with which the defined field of an input item is to be compared. 

The maximum number of characters that the VAL parameter can define 
is 30. Blanks are significant. 


If the second parameter in the list (prefixed by the keyword REL) is not specified, the 
standard for deletion of an input item is equality with the value specified by the VAL parameter. 
The default assumption is that the delete function is not required. 


Exits Statement 

The Exits statement (see Figure 4-9) specifies own-code exits from the sort to user pro- 
cedures. If the Exits statement is omitted, there are no own-code exits. 
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Figure 4-9. Parameters for the Exits Statement 
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PRESORT OPEN EXIT PARAMETER 

The presort open parameter (PSOPEN) specifies an own-code exit that permits the user to 
have access to the file description index item or to input tape labels. The default assumption is 
that there is no presort open exit. This parameter has the following form. 

| PSOPEN = address. 

address - The address to which the sort will branch (up to six decimal digits in 
length). 

PRESORT ITEM EXIT PARAMETER 

This exit parameter (PSITEM) must be specified if all the items to be processed are to be 
entered through own-coding. If all input is not through own-coding, this parameter specifies an 
own-code exit that occurs for each accepted (selected) input item. The default assumption is 
that there is no presort item exit. 

I PSITEM = address, 

address - The address to which the sort will branch (up to six decimal digits in 
length). 

MERGE PARAMETER 

The merge parameter (MERGE) specifies an own-code exit that occurs for each sort item 
when the final output of the sort is being created. The default assumption is that there is no 
exit. The merge own-code routine will be linked with the sort during the final phase of the 
merge. This parameter takes the following form. 

| MERGE = address, 

address - The address to which the sort will branch (up to six decimal digits in 
length). 

PROGRAM PARAMETER 

The program parameter (PROG) specifies that a named program is to be loaded by the sort 
for the own-code merge exit. This parameter has the following form. 

I PROG - program-segment -name, 

program- segment-name - The 8-character program-segment-name of the 

program to be loaded. 

The default assumption is that the merge own-coding was resident in main memory before 
the final merge phase. 
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VISIBILITY PARAMETER 

The visibility parameter (VIS) specifies the visibility mask of the merge own-code pro- 
gram. The visibility parameter has this form. 

|~ VIS = visibility-mask, 

vi s ibility-ma sk - The visibility mask to be used in loading the merge own-code 
program. 

The default assumption is that visibility is not used when the sort is loading the merge 
own-code program. 

Job Control Language Examples for Mass Storage Sort C 
EXAMPLE 1 

The source-item file is on mass storage and is named "TRANSACT" (see coded example 
below). The device address assigned is the assumed configuration 04, 0. One work file is 
available under the name "*SORTWORK, " and its device address is likewise the assumed con- 
figuration 04, 0. The highest memory address is taken from the Supervisor communication 
area, and the output sequence is ascending. The sort item consists of one key with the hard- 
ware address of the associated input item appended. 
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EXAMPLE 2 

A sort is to be executed on the file whose name is "TRANSACT" (see coded example below) 
and whose volume resides on a mass storage device with a peripheral address assignment of 07 
for the control unit and a device number of 0. There are two work files with names and addresses 
given. The high memory address is 19,045, and the output is in descending sequence. The final 
output is a string of input items having the characters "LOBSTERAPOT, " starting in position 40. 
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EXAMPLE 3 

Sort the mass storage file "TRANSACT," but bypass as input to the sort those items that 
have the characters ZZZZ, beginning in position 10 (see coded example below). Two work files 
are available; the primary work file is named " *SORTWORK, " and the secondary work file is 
named "EXWORK.” Both are assigned the assumed device address (04, 0). The sort item 
consists of two extract fields followed by three key fields; the item address is appended. Merge 
own-coding is required, and the sort is to call the own-code program. The highest memory 
address is 8(4096)-l = 32,767. 
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EXAMPLE 4 


Sort the mass storage file that resides on two volumes. Three work files are available. 

The primary work file is named "*SORTWORK" and is on the volume assigned to control unit 04 
and drive 0 (default assumptions). The second file is named "EXWORK" and is on the same 
volume as "*SORTWORK. " "NEWWORK" is the name of the third work file, and it resides on two 
volumes. The output from the sort is to be the previously allocated sequential file "OUTSTAND"; 
it resides on two volumes. 
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EASYCODER 
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EXAMPLE 5 

The mass storage input file "TRANSACT" resides on the volume at control unit 04 and 
drive 0. The work file is "*SORTWORK" and resides on the same volume as the input file. The 
sort -item block size is to be restricted to four physical records, and a check is to be made to 
ensure that the size of the work area is sufficient to contain 5000 items. Select from the input 
file only those items with a 4-character field (starting in position 50) and with a value greater 
than or equal to 1000. The selected items are to be sorted on two keys in the commercial col- 
lating sequence. 
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EXAMPLE 6 

The sort is not to be executed. Calculations are made to determine the sort -item block 
size and the work area compatibility. The results of these calculations are made available to 
the user by means of the printer. 
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EXAMPLE 7 

In this example, the input file to the sort is on tape. The device address is pcu 00, drive 
1. No name check is to be applied to the input file. Item length and record size are as specified, 
and the tape format is bannered, standard labels with odd parity. The padding character is 77g. 
An output file on 1 /2-inch tape is created; it contains the sort items. The output file name is 
"SORTED-OUT 1 '; items on it are blocked two per record. The format of the output tape is the 
same as the input tape. 
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EXAMPLE 8 

All items to be processed are entered through own-coding. The sort branches to location 
29, 000 to receive each item and its corresponding mass storage address. 
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EXAMPLE 9 

Input items are entered through the card reader at pcu 41. The standard mode is used for 
reading cards. Following the sort, the sequential output file program is called, and a file con- 
taining the sort items is created on 1 /2-inch tape. The format of the output tape is bannered, 
standard labels in odd parity. Dummy labels are created and items are blocked two per record. 
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Examples of Work File Parameters Resident in Main Memory 
EXAMPLE 1 

The file named "USEWORK" is to be used for the work area; it exists on two volumes 
which are to be assigned addresses (04, 0) and (04, 1). This work area must be described by 
two items in the parameter area, one for each volume as follows. 

Characters Values 


51-60 

USEWORKAAA 

61-63 

(040000)g 

64-73 

USEWORKAAA 

74-76 

(040100) g 


EXAMPLE 2 

Suppose that the file described in example 1 above is to be used, and a second work file is 
to be added. Assume that the second work file is called "DOESWORK" and that it resides on 
three volumes. The first volume of "DOESWORK" is the same as the first volume of "USEWORK, " 
so that it is assigned address (04, 0). The second and third volumes of "DOESWORK" are 
separate from "USEWORK" and are to be assigned addresses (04, 2) and (04, 3). Then, the first 
two work-file fields (characters 51-76) remain as shown in example 1, and the following fields 
are defined. 

Characters Values 

343-352 DOESW ORKAA 

353-355 (040000) g 
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Characters 

Values 

356-365 

DOESWORKAA 

366-368 

(040200)g 

369-378 

DOESWORKAA 

379-381 

(040300) g 


EXAMPLE 3 

Three work files are available to the sort. The first of these is " *SORTW ORK, " and its 
three volumes are assigned addresses (04, 0), (04, 1), and (04, 2), respectively. "USEWORK" 
is a single-volume file on address (04, 1). The third work file "DOESWORK" exists across 
three volumes, but only one volume is to be used, and it is assigned address (04, 0). The pa- 
rameter values in memory which describe the work area of the sort are as follows. 

Characters Values 


51-60 

#SORTW ORKA 

61-63 

(040000) g 

64-73 

*SORTWORKA 

74-76 

(040100) g 

343-352 

*SORTW ORKA 

353-355 

(040200) g 

356-365 

USEW ORKA A 

366-368 

(040100) 8 

369-378 

DOESWORKA 

379-381 

(040000) g 


Parameters Resident in Main Memory 

When the parameters to the sort are resident in main memory prior to the sort being 
called, no default conditions are allowed; i. e. , the complete parameter area must be specified. 
The starting location of the parameter area is 210 (decimal). Tables 4-2 and 4-3 provide sum- 
maries of the parameters resident in main memory. 

If it is desired to calculate the decimal memory address of the parameter characters, add 
209 (decimal) to the number in the "Characters" column of Tables 4-2 and 4-3. 
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Table 4-2. Sort Parameters Resident in Main Memory 


Parameter 

Name 

Characters 

Value 

Description 

Input File * 
(Mass Storage 

1-10 

Input File 
Name 

Source -item file name. 

Resident) 

11-18 

Password 

Password. 


19-21 

xx 8 

Address of primary input file control unit. 



ox 8 

Address of primary input file device. 



00 8 

Address of primary input file pack address. 


22-24 

Address of the second volume of a multivolume 



input file. 


25-27 

Address of the third volume of a multivolume input 


• 

• 

file 

• 


40-42 

Adc 

ress of the eighth volume of a multi volume in- 



put file. 

Input File ^ 

1-10 

Input file name or blank. 

(Tape Resident) 

11-18 

A 

Blank 


19-20 

ox 8 

Primary device address expressed in two 




characters: 



XX 

Tape control unit = XXg 



° X 8 

Drive = OXg 


21 

A 

Blank 


22-23 

Alternate device address or blank. 


24 

A 

Blank 


25 


Parity 



A 

A = Odd 



E 

E = Even 


26 


Labels: 



N 

N = No labels 



A 

A = Standard labels 


27 

A 

Blank 


28 

Padding character . 


29 


Banner parameter: 



A 

A = Bannered file 



N 

N = Unbannered file 


30 


Device type: 



T 

T = Tape 


31 

Number of reels or blank if standard labels. 


32-42 

A 

Blank 
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Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 




Name 

Characters 

Value 

Description 

Input File 1 
(Card) 

1-10 

A 

Blank. 

11-18 

A 

Blank. 


19 

xx 8 

Peripheral control unit address. 


20-26 

A 

Blank. 


27 


Mode: 



S 

S = Standard card mode. 



A 

A = Special card mode. 


28-29 

A 

Blank 


30 


Device type: 



C 

C = Cards. 


31-42 

A 

Blank 

Input Through 1 

1-10 


Blank 

Own -Coding 

11-29 

A 

Blank 


30 


Device type: 



0 

0 = Own-coding (46 octal). 


31-42 

A 

Blank 

Translation 

43 

A 

A = No translation. 



T 

T = Translation. 

Precalculation 

44 

A 

A = Sort is to be executed. 

Parameter 


Y 

Y = Sort is to return to the 




Supervisor after completing 
requested calculation. 

Volume of Input 

45-50 


The number of input items in decimal with 

Parameter 



leading zeros. Blank - if no work area 
calculation is requested. 

Work File* 1 

51-60 

Name of 

Refer to the paragraph, "Examples of Work- 

Parameters 


primary 

File Parameters Resident in Main Memory" 



work file 

in this section, for handling multivolume 
work files. 


61-63 

Device 

Device address of primary work file ex- 
pressed in three characters: 



xx 8 

XX 8 = Control unit. 



ox 8 

0X 8 = Device, and 



oo 8 

00g = Magazine. 


64-73 


Name of secondary work file. Blank if not 
used. 


74-76 

Device 

Device address of secondary work file ex- 
pressed in three characters: 
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Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 

Name 

Characters 

Value 

Description 

Work File 2 
Parameters 
(cont) 


**8 

° X 8 

00 8 

XXg = Control unit \ 

OXg = Device ( Blank 

l not used. 

008 = Magazine ) 

Sort -Item 

Block Restriction 

Parameter 

00 


The maximum number of 250 -character 
physical records that the sort can use to 
contain the sort-item block expressed in 
decimal with leading zeros. Blank if the 
option is not used. 

Select and 
Delete Condition 
Parameter 

79 

See 

"Description" 

column. 

Select parameter: 

42 - for equal condition. 

45 - for unequal condition. 

41 - for greater than condition. 

44 - for less than condition. 

43 - for greater than or equal condition. 

46 - for less than or equal condition. 
Blank if select option not used. 

80 


Delete parameter: 

Values same as for select parameter. 
Blank if delete option is not used. 

Information File 

81 

xx 8 

Peripheral address assignment of printer 
control. Must be blank if not used. When 
this parameter is specified, the program 
history is printed. 

Highest Memory 
Address 

82-87 

See 

"Description" 

column. 

This is the highest memory address avail- 
able to the sort and can be expressed in 
any of the following three ways: 

1. In decimal, with leading zeros; 

2. As the number of 4K modules, with 
leading zeros; or 

3. Asa binary address, right -justified 
in the parameter field and with lead- 
ing spaces. 

88 

A 

Reserved for use of the operating system; 
must be set to blank. 

Presort 
Own -Coding 

89-94 

See 

"Description" 

column. 

The decimal address with leading zeros, to 
which the presort branches when a file 
description index or a tape label has been 
read. Blank if the option is not used. 
Alternatively, the address can be specified 
as a binary value, right-justified with lead- 
ing blanks. 

95-100 

See 

"Description" 

column. 

The decimal address, with leading zeros, to 
which the presort will branch: (1) after the 
presort has been specialized, and (2) just 


7/15/70 


4-36 


#3-619 























SECTION IV. MASS STORAGE SORT C 


Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 

Name 

Characters 

Value 

Description 

Presort Own- 
Coding (cont) 



prior to processing each item. Blank if the 
option is not used. Alternatively, the ad- 
dress may be specified as a binary value, 
right -justified with leading blanks. An ad- 
dress must be specified if input is through 
own-coding only. 

Merge Own- 
Coding 

101-106 

See 

"Description" 

column. 

The decimal address, with leading zeros, 
to which the final merge phase will branch 
when an item has been processed. The 
merge is said to be in its final phase when 
it is producing the single string output. 
Blank if this option is not used. Alter- 
natively, the address may be specified as a 
binary value, right-justified with leading 
blanks. 

Merge Own- 
Coding Program 

107-112 


Merge own-coding program name (this pa- 
rameter is blank if the option is not used). 


113-114 


Merge own-coding segment name. 


115-120 


Visibility mask associated with merge own- 
coding program. Blank if not used. 

Ascending or 
Descending Output 

121 

A 

D 

Ascending sequence. 1 When a mixed se- 

l quence is required. 
Descending sequence. 1 it is expressed 

through the reverse- 
key parameter. 

Item Address 
Appendage 

122 

A 

Item address is to be appended to the sort- 
item. 



N 

Item address is not to be appended to the 
sort-item. 


123-126 

dddd 

Position of the primary sort key. 

*2 

127-128 

dd 

Number of characters in primary key. 

Sort -Key Fields 5 

(Up to ten key fields 
may be specified, in 
decreasing order of 
importance. ) 

129 

A 

R 

Key is to be sorted in the sequence defined 
by character 121. 

Key is to be sorted in sequence opposite that 
defined by character 121. 

130-136 


Second key parameters (same as characters 
123-129). 


137-143 


Third key parameters (same as characters 

123-129). 


144-150 


Fourth key parameters (same as characters 
123-129). 


151-157 


Fifth key parameters (same as characters 
123-129). 
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Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 

Name 

Characters 

Value 

Description 

Sort -Key 
Fields (cont) 

158-164 


Sixth key parameters (same as characters 
123-129). 


165-171 


Seventh key parameters (same as charac- 
ters 123-129). 


172-178 


Eighth key parameters (same as characters 

123-129). 


179-185 


Ninth key parameters (same as characters 
123-129). 


186-192 


Tenth key parameters (same as characters 
123-129). 

Extract Fields^ 

193-196 

dddd 

First extract field position. 



ITEM 

Extract fields are the residue of the item. 


197-198 

dd 

Number of characters in the first extract 
field. 


199-204 


Second extract field (same as characters 
193-198). 


205-210 


Third extract field (same as characters 
193-198). 


211-216 


Fourth extract field (same as characters 
193-198). 


217-222 


Fifth extract field (same as characters 
193-198). 


223-228 


Sixth extract field (same as characters 
193-198). 


229-234 


Seventh extract field (same as characters 
193-198). 


235-240 


Eighth key extract field (same as characters 
193-198). 


241-246 


Ninth extract field (same as characters 
193-198). 


247-252 


Tenth extract field (same as characters 
193-198). 


253-258 


Eleventh extract field (same as characters 
193-198). 

Select Option 

259-262 

dddd 

Position of the leftmost (high-order) charac- 
ter in the item of the field on which the sort 
is to be selected. Expressed in decimal 
with leading zeros. 



AAAA 

Select option not used. 
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Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 

Name 

Characters 

Value 

Description 

Select Option 
(cont) 

263-293 


These are the characters of the select field. 
Definition of the field must be terminated 
by a comma. Embedded blanks are signi- 
ficant. A comma may not be a character of 
the select field. The maximum size of a 
select field is 30 characters. 

Delete Option 

294-297 

dddd 

The position of the leftmost (high-order) 
character of the delete field of the item. 
Expressed in decimal with leading zeros. 



AAAA 

Delete option not used. 


298-328 


These are the characters of the delete field. 
Definition of the delete field must be termi- 
nated by a comma. Embedded blanks are 
significant. A comma may not be a charac- 
ter of the delete field. The maximum size 
of the delete field is 30 characters. 

Call Next 
Program 

329-336 


Program and segment name of the program 
to be loaded at the completion of the sort. 

If blank, the sort returns to the Supervisor 
at completion. 


337-342 


Visibility mask associated with the program 
to be loaded. Blank if not used. 

Additional 

343-352 


Name of third work file. 

Work File 

353-355 

(XX) g 

(0X) 8 

(00)g 

Address of third work file control unit. 
Address of third work file device. 
Address of third work file magazine. 


356-365 


Name of the fourth work file. 


366-368 


Device address of fourth work file. 


369-378 


Name of fifth work file. 


379-381 


Device address of fifth work file. 

Output^ 

File 

(Mass Storage 
Resident ) 

382-391 


Name of the sequential output file, up to ten 
characters with trailing blanks. If blank, 
there is no request for a sequential output 
file. 

392-399 


Password, if any, associated with the se- 
quential output file. If blank, no password 
is required. 


400-402 


Device address for first volume (relative 
volume 0) of the file. 



(XX) 8 

(0X) 8 

(00) 8 

Address of first volume control unit. 
Address of first volume device. 
Address of first volume magazine. 
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Table 4-2 (cont). Sort Parameters Resident in Main Memory 


Parameter 




Name 

Characters 

Value 

Description 

5 

Output File 

403-405 


Device address for second volume (relative 

(Mass Storage 

• 


volume 1) of the file. 

Resident) 



• • • 

(cont) 



• • • 


421-423 


Device address for eighth volume (relative 
volume 7) of the file. 

Output File ^ 

382-391 


Name of output file, up to 10 characters with 

(Tape Resident) 



trailing blanks. Default assumption is blank. 
Blanks if there is no request for a tape 
resident output file. 


392-399 

A 

Blanks. 


400-401 

xx 8 

Tape control unit. | Primary device address 



0X 8 

/ expressed as two char- 
} acters. 


402 


Blank , 


403-404 


Alternate device address or blank. 


405-423 


Blank. 

Additional Input 

424-427 


Input item length expressed in decimal with 

File Parameters 



leading zeros. Must be blank if input file 
is on mass storage. 


428-431 


Input record length expressed in decimal with 
leading zeros. Must be blank if input file 
is not on tape. 

Additional Out- 

432 

T 

T - Tape. ) Output device type (also 

put File Pa- 
rameters 


A 

. } blank if there is no re- 

A = Mass Storage. 

f quest for an output file). 


433-436 


Output record length expressed in decimal 
with leading zeros. If blank, there is no re- 
quest for a tape-resident output file. 

Reserved by Sort 

437-440 

A 

Reserved for future use by the sort (must be 
blank). 


Additional input file parameters appear in characters 424-431. 

"Three examples of the use of work file parameters are provided on page 4-32. 

5 Specification of each field requires seven characters. Four characters are used for position of 
the leftmost (high-order) character in the field, and two are used for the number of characters 
in that field (both in decimal with leading zeros). The seventh character is defined as the re- 
verse-key parameter, and its use permits the key with which it is associated to be in reverse 
sequence from that specified by the parameter in character 121. If less than ten key fields are 
used, the remaining key field parameter area must be blank. The first character of an item is 
considered to be in position 0001. 

^If less than 11 extract fields are used, the remaining extract field parameter area must be blank. 

The application requiring that the final output of the sort be a sequential file that obeys the Data 
Management Subsystem conventions must describe the file in the output file parameters, unless 
the sequential output file prograrti is to be called through the Execute statement. 
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Table 4-3. Summary of Sort Parameters Resident in Main Memory 


Parameter 


Characters 

Use 

1-42 

Input file parameters. 

43 

Translation parameter. 

44 

Precalculation parameter. 

45-50 

Volume of input parameter. 

51-60 

Name of primary work file. 

61-63 

Device address for primary work file. 

64-73 

Name of second work file. 

74-76 

Device address for record work file. 

00 

i 

I s - 

Sort -item block restriction parameter. 

79-80 

Select and delete condition parameter. 

81 

Printer control address assignment. 

82-87 

Highest memory address. 

88 

Reserved. 

89-94 

Presort open own-coding address. 

95-100 

Presort item own-coding address. 

101-106 

Merge item own-coding address. 

107-114 

Merge own-coding program and segment name. 

115-120 

Visibility mask. 

121 

Principal sort sequence. 

122 

Item address appendage. 

123-129 

First sort-key information. 

• 

186-192 

• 

• 

Tenth sort -key information. 

193-198 

First extract field information. 

• 

253-258 

• 

• 

Eleventh extract field information. 

259-262 

Select field position. 

263-293 

Select field value. 

294-297 

Delete field position. 

298-328 

Delete field value. 

329-336 

Program and segment name of segment to be loaded. 

337-342 

Visibility mask of program to be loaded. 

343-352 

Name of third work file. 

353-355 

Device address of third work file. 
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Table 4-3 (cont). Summary of Sort Parameters Resident in Main Memory 


Parameter 


Characters 

Use 

356-365 

Name of fourth work file. 

366-368 

Device address of fourth work file. 

369-378 

Name of fifth work file. 

379-381 

Device address of fifth work file. 

382-423 

Output file parameters. 

424-431 

Additional input parameters. 

432-436 

Additional output file parameters. 

437-440 

Reserved for future use. 


PROGRAMMER'S PREPARATION INFORMATION FOR MASS STORAGE SORT C 
Work Files 

Under certain conditions, the sort can utilize five work files. If five work files are pro- 
vided for the sort work area, they may exist on the same volume, or each may be on a different 
volume. The device address associated with the five work files must be assigned to the same 
control unit. A work file must have been properly allocated through the File Support C program 
as a sequential file with 250-character records. All volumes of the work files must be mounted 
throughout the operation of the sort, the Fetch macro routine, and the sequential output file 
program. 

All volumes of the work files must belong to the same device class (see Table 4-4). How- 
ever, an input file does not have to belong to the same device class as its work files (see 
Table 4-5). 


I 


Table 4-4. Device Class Table 



Units of Allocation 

The sort work area may be defined as five units of allocation or less. If the total number 
of units of allocation associated with the work files exceeds five, the extra units will be ignored, 
except that the sort uses the last record of the last unit of allocation for internal control infor- 
mation. This record is also used to store information for the Fetch macro routine. If the se- 
quential output file program is requested for execution through sort parameters, the next to last 
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record of the last unit of allocation is used to record information for the sequential output file 
program. When the number of units of allocation is five or less, the last two records of the last 
unit of allocation are similarly used. 


Table 4-5. Work File Table 


Input File 

Work File 

Class A 

Class A 


or 


Class B 


or 


Class C 

Class B 

Class A 


or 


Class B 


or 


Class C 

Class C 

Class A 


or 


Class B 


or 


Class C 


There are no restrictions on the units of allocation, but to achieve optimum efficiency, 
they should have the following characteristics. 

1. The unit of allocation should consist of as few cylinders as possible. 

2. The number of units of allocation should be as small as possible. 

3. If a source file exists on one device and a work file is available on a second 
device, the work file should be specified to the sort as WORK1. 

4. When the work file and the source file are on the same device, the work file 
should be as physically near the source file as possible. 


Maximum Acceptable Sort-Item Size 

The maximum sort-item size acceptable to the sort is the lesser of the two values derived 
by the following calculations. (The calculation of PS and PM in the following formulas is con- 
tained in Appendix A. ) 

1. PS - INB - 25 

2 

INB = the size of the input block. 

2. PM - 34 

3 

A further restriction on the size of the sort-item block is that it cannot exceed 3, 741 characters 
in length. 


1/5/70 


4-43 


#3-619 




SECTION IV. MASS STORAGE SORT C 


Restriction of Sort-Item Block Size 

The sort-item block size is determined by the sort so that its processing is as efficient as 
possible. It is possible that this sort -item block size might prove to be too large for the 
memory available during the execution of a process that includes the Fetch function. To avoid 
this difficulty, there is an option to allow the user to specify the maximum number of 250-char- 
acter physical records that may be used to contain the sort -item block (see "Sort-Item Block 
Restriction Parameter, " in this section). It is important that this option should only be used if 
the sort determined sort -item block size is too large to be used by some subsequent process. 

Calculation of Required Sort Work Area 

The sort handles up to five units of allocation that may be within one work file or split 
across as many as five work files. If the total number of units of allocation assigned to the 
file(s) is five or less, the last record of the last unit of allocation is used as storage for internal 
sort control information. It is also used to pass information to the Fetch function. If the se- 
quential output file program is requested by the specification of a File Out statement in the sort 
job control file, the next to last record of the last unit of allocation is used to record information 
for the sequential output file program. 

Refer to Appendix A for the calculation of some of the following parameters. 

POSSIBLE NUMBER OF SORT ITEMS IN UNIT OF ALLOCATION 

If a unit of allocation is defined as C^TjC 2 T 2 where C^Tj stands for the numerical values 
of cylinder Cj and track T the number of 250-character physical records on a cylinder de- 
pends on the device type. 

For Type 155, 258, 259, 273, 259A, and 259B Disk Pack Drives, the number of records 
per cylinder is determined by the formula: 

15 (T - T + 1) = NRC. 

For a Type 261 or Type 262 Disk File, the number of records per cylinder is determined 
by the formula: 

30 (T - T + 1) = NRC. 

After determining the number of records on a cylinder, proceed as follows: 

1. Calculate the number of physical records required to contain a sort-item 
block (SIB): SIB = NI(SIS). 
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Using Table A-l or A-2, find in column A the least value equal to or greater 
than SIB. The number of physical records required to contain a sort -item 
block is given by the corresponding value in column B. Let this value be 
represented by PRC. For example, if SIB = 730, a search of Table A-l 
would show the value 741 in column A; therefore, PRC = 3 (the corre- 
sponding value in column B). 

2. Calculate the number of sort items contained within a cylinder (NC): 

[ NRC 1 

(NI) (rounded to the next lowest integer). 

PRC J 

3. Calculate the number of sort items that may be contained within a unit of 
allocation: 

a. When the unit of allocation is not the last unit and the total num- 
ber of units of allocation common to the specified work file(s) 
exceeds five, the number of sort items = 

NC [ C 2 - Cj + 1 ] 

b. When the unit of allocation is the last one to be used and the total 
number of units for the work file(s) is five or less, the number 
of sort items = 

NC [C 2 -C 1 + 1] -2NI 

c. When the unit of allocation is the last one to be used and the total 
number of units of allocation common to the specified work file(s) 
exceeds five, the number of sort items = 

NC [ C 2 - C 2 + 1 ] -NI 


NUMBER OF WORK CYLINDERS REQUIRED TO HANDLE INPUT 

If the difference between the highest and lowest tracks (T - T ) is the same for all units 

£ 1 

of allocation, the number of cylinders (CR) required to handle the input when there are five or 
less units of allocation is calculated as follows: 

1. For Type 155, 258, 259, 273, 259A, and 259B Disk Pack Drives 

_ R (I + 2NI) PRC (rounded up to the next highest integer). 

15(T 2 - T } + 1) (NI) 

2. For Type 261 and 262 Disk Files 

rR (I + 2NI) PRC 

30(T 2 - T x + 1) (NI) 

I = total number of input items to the sort. 


If the work files have more than five units of allocation, the formula becomes: 

1. For Type 155, 258, 259, 273, 259A, and 259B Disk Pack Drives | 

C R _ (PRC) (I + NI) 

15(T 2 - T + 1) (NI) 
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2. For Type 261 and 262 Disk Files 

rR _ (PRC) (I + NI) 

^ " 30(T 2 - Tj + 1) (NI) 


Ensuring Sufficient Work Area 

If the user provides, through the job control file, the size of the input file to the sort (re- 
fer to "Volume of Input Parameter, " in this section) a calculation is made to ensure that the 
work area defined by the specification of the work files is sufficient for the successful com- 
pletion of the sort. When the work area is insufficient, a message is given through the operator 
control file indicating the number of additional 10-track cylinders required to meet the demands 
of the input file. The message also gives the total number of 10-track work area cylinders re- 
quired to contain all the items. When a printer is available, this information is also listed. 

The Precalculation Option 

The precalculation option (see "Precalculation Parameter" in this section) permits the cal- 
culation of both the sort-item block size and the work area compatibility. The information is 
made available through the printer and/or the operator control file and then a return is made to 
the Supervisor. The sort is not executed. 

Sort Own-Coding 

The various types of own-coding functions that may be performed during sort execution are 
described below. It is important that all own-coding routines which modify index registers re- 
store them prior to returning control to the sort, with the exception of index registers XI and 
X2 when they are used as the item linkage through which an item may be added. There are four 
types of sort own-coding: 

1. Presort open; 

2. Presort item-by-item; 

3. Own -coding -only source of input to the sort; and 

4. Merge own-coding. 

The four types of sort own-coding are described below under separate headings. 

The following definitions are given for the benefit of the reader. 

1. Normal Return: A return of control to the sort from an own-code program 
which is made by branching to the location specified by the contents of the 
B-address register when control was given to the own-code program. 

2. Branch-space Constant: The number of characters required for a branch 
operation code and one address field. If the sort is operating in the 3- 
character mode, the value of this constant is "4." 
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PRESORT OPEN OWN-CODING 
Mass Storage Input 

The presort branches to the location specified by the value of the presort open parameter 
when it has read the item in the file description index (^VOLDESCR*) of the first volume of the 
input file. There is an option not to exit to the open own-code program for every volume of a 
multivolume input file* Index register XI contains the address of the left (high-order) end of 
that item. If accessing the input file requires the specifying of the password parameter, the item 
is not made available until this obligation has been met. Principally, the item can be inspected 
and moved to the own-code program area; no punctuation is present in the sort area it occupies. 

If the own-code program punctuates the sort area, it must clear that punctuation before returning 
control to the sort. If open own-coding is to be executed for successive volumes of the file, the 
presort is reentered at the location defined by the contents of the B -address register when the 
presort branched to the own-code program. Open own-coding can be terminated after any volume 
by branching to a location whose address is formed by adding a branchspace constant to the nor- 
mal address. A store control register (SCR) instruction of the B-address register should be the 
first instruction of the presort open own-coding. 

Tape Input (Standard Labels) 

The presort branches to the location specified by the value of the presort open parameter 
when it has read the header from the first reel of the input file. There is an option not to exit 
to the open own-code routine for every reel of a multireel input file. Index register XI contains 
the address of the left (high-order) end of that label. Principally, the label can be inspected and 
moved to the own-code program area; a word mark is present on the left end of the sort area it 
occupies. If the own- code program punctuates the sort area further, it must clear that punctua- 
tion before returning control to the sort. If open own- coding is to be executed for successive reel 
of the file, the presort is reentered at the location defined by the contents of the B-address regis- 
ter when the presort branched to the own-code program. Open own-coding can be terminated 
after any reel by branching to a location whose address is formed by adding a branchspace con- 
stant to the normal address. A store control register (SCR) instruction of the B-address register 
should be the first instruction of the presort open own-coding. 

When the final trailer (1EOFA) of the input file has been read, the presort branches to the 
location specified by the value of the presort open parameter, unless the user has previously 
terminated open own-coding after examining a header. Index register XI contains the address of 
the left (high-order) end of the label. An item mark is set on the location specified by the open 
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address plus 1 to indicate the label is a trailer. Procedures followed by the own -code routine 
are identical to those used when the label is a header. The presort is reentered at the location 
defined by the contents of the B-address register when the presort branched to the own-code 
routine. 

PRESORT ITEM-BY-ITEM OWN-CODING 

The description of own-coding that follows assumes that own-coding is not the only source 
of input to the sort. 

The five options in presort, item-by-item own-coding are described below under the fol- 
lowing separate headings: 

1. Processing an item; 

2. Adding an item; 

3. Deleting an item; 

4. Terminating item own-coding; and 

5. Terminating reading from the input file. 

Processing an Item 

The presort branches to the location specified by the value of the item-by-item parameter 
prior to processing each input item. However, if that item meets the standard for the Delete 
function, the item is not available to the user. Index register XI contains the address of the left 
(high-order) character of the item as it resides in the sort's input buffer. The item's contents 
can be modified, but not its length. If the item is not from a mass storage index sequential file , 
a tape file, or a card file, punctuation is present in the item; a word mark appears on the high- 
order character of every key field and extract field pertinent to the particular sort application. 
Change in the status of the item punctuation leads to unpredictable results. Item punctuation is 
illustrated in Figure 4-10. Control is returned to the sort by making a normal return. 

Adding an Item 

An item, or those fields of an item relevant ot the sort application, can be added by plac- 
ing the address of the left (high-order) character of the item in index register XI. The item 
must have the same format as the specified input, that is, item length, key fields, and so forth. 
Word marks must appear in the item in the following locations (unless the input file is a mass 
storage index sequential file, a tape file, or a card file in which no punctuation can be present 
in the item to be added) : 

1. In the first character of each key field and 

2. In the first character of each extract field. 
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If an item sort has been specified, every nonkey field of the item is treated as an extract; 
thus, a word mark is required on the first character of all such fields. This convention is illus- 
trated in Figure 4-10. 



KEY 


KEY 

KEY 

1 


# 2 


# 1 

# 3 

■ 


WM WM WM 


A. Punctuation in the source item when only key fields have been specified. 



EXT 


EXT 


EXT 


KEY 

KEY 

■ 

EXT 



# 3 


# 4 


# 2 

1 

# 2 

# 2 


# 1 

1 


WM WM WM WM WM WM 

B. Punctuation in the source item when key and extract fields have been 
specified. 



KEY 


KEY 

KEY 



# 2 


# 1 

# 3 



WM WM WM WM WM WM 


I C. Punctuation in the source item when an item sort has been specified. 

Figure 4-10. Source -Item Punctuation 

When the sort application specifies that an item address is to be appended to the sort item, 
the own-code program must supply this address to the sort. This is done by placing the address 
of the high-order character of an 11 -character field in index register X2. The contents of this 
11 -character field can be an item hardware address, but the presence of a single character 
(77 ) in the high- order position of that field indicates to the Fetch macro routine and the sequen- 
tial output file program that the item does not exist on the online mass storage device(s). When 
the address is a valid one, the format is as follows. 

1. Device Address - Character 1: Address assignment of control with high - 

order bit of zero. 

Character 2: Drive number. 

Character 3: Pack address. 

2. Block Address - Characters 4 and 5: Cylinder number. 

Characters 6 and 7: Track number. 

Characters 8 and 9: Number of record at the beginning of 

block containing the item. 
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Characters 10 and 11: Relative item number in the block; 

the number for the first item in the 
block is zero. For example, the 
fifth item in a block would have a 
relative item number of four. 

No punctuation can be present in the 11-character field, except for an optional word mark in 
the high-order (leftmost) character. This field is illustrated in Figure 4-11. 


PCU 

D 

P 

c 



c 



D 

a 

— 

R 



R 

TIT 


where: PCU = Peripheral address assignment of control 
D = Drive number 
P = Pack address 
CC = Cylinder 
TT = Track 

RR = Number of record at the beginning of block con- 
taining the item 

II = Relative item number in the block, counting the 
first item in the block as zero 

Figure 4-11. Contents of Item Address Appended to Sort Item 

Control is returned to the sort by branching to a location whose address is formed by add- 
ing a branchspace constant to the normal return address. 

Deleting an Item 

When an item is to be deleted from the sort after inspection of that item by own-coding, the 
presort is reentered by branching to a location with an address formed by adding two branchspace 
constants to the normal return address. 

Terminating Item Own -Coding 

When all item own-code processing is completed, the own-coding routine must branch to a 
location whose address is obtained by adding three branch-space constants to the normal return 
address. Presort item own-coding can be terminated before or after the presort has processed 
all its input. However, the own-coding routine must be terminated. An item mark set on the 
location specified by the own-coding address indicates that the presort has processed all its in- 
put. If more items are to be added, the own-code program follows the procedure for adding an 
item. The presort will continue to exit to the own-code program until the terminating own-code 
return is made. 

Terminating Reading from the Input File 

The user can terminate reading from the input file by branching to a location, the address 
of which is obtained by adding four branchspace constants to the normal return address. The 
last item examined is not included in the input to the sort, and the presort make no further exits 
to the own-code routine. 
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OWN-CODING - ONLY SOURCE OF INPUT TO THE SORT 

The presort branches to the location specified by the value of the PSITEM parameter in 
order to retrieve each input item. An item may be entered for processing by placing the address 
of the leftmost (high-order) character of the item in index register XI. No punctuation should 
appear in the item. When the sort application specifies that an item address (see "Item Address 
Parameter, " in this section) is to be appended to the sort item, the own-code program must 
supply such an address to the sort by placing the address of the high-order character of an 11- 
character field in index register X2. 

The contents of this 11 -character field may reflect a genuine item hardware address. 
However, the presence of a single character (77) in the high-order position of the field, indi- 

O 

cates to the Fetch and sequential output file programs that the item does not reside on a mass 
storage device. When the address is a valid one, the format is as described in the paragraph, 
"Adding an Item, " in this section. 

No punctuation may be present in the 11-character field with the exception of an optional 
word mark on the high-order character. 

Control is returned to the sort by branching to a location whose address is formed by add- 
ing a branchspace constant to the normal return address. 

When all items have been entered, the own-coding routine must branch to a location whose 
address is obtained by adding three branchspace constants to the normal return address. It is 
necessary that own- code processing be terminated. 

The presort continues to exit to the own-code program until the terminate own-coding re- 
turn is made. 

MERGE OWN-CODING 

Only when the merge is creating its final 1-st.ring output will it branch to the location 
specified by the merge own-coding parameter. The address of the high-order character of the 
sort item, as it is in the output buffer, will be found in index register XI when the branch occurs. 
The item may be inspected, modified, or moved to the own-code area; but when control is re- 
turned to the sort, all punctuation of the item must be cleared to its original state. The punc- 
tuation and the format of the sort item, when the sort item is made available to the merge own- 
code program, are shown in Figure 4-12. When the merge has processed all the sort items, 
an item mark is set in the merge own-code location and an own-code branch is taken. It is not 
necessary that the program return control to the sort after this last exit is taken. Control is 
returned to the sort by making a normal return. 
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KEY #1 
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1 

ITEM ADDRESS I 
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B. KEYS AND EXTRACTS 


NON- KEY 

KEY 
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C. ITEM SORT 


Figure 4-12. Punctuation and Format of Sort Item When Made Available 

to Merge Own-Code Program 


DETAILED DESCRIPTION OF FETCH MACRO ROUTINE 

The language elements and the programmer's preparation information for the Fetch macro 
routine are described below. Additionally, a description of the Fetch macro routine use of the 
Physical I/O C program is provided. 

Language Elements of Fetch Macro Routine 

The Fetch macro routine has the name "MFTCH. " One Fetch macro call is required per 
program using the Fetch function. The format of the Fetch macro routine is shown below. 
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PROBLEM PROGRAMMER DATE FAGE OF 


CARD 

NUMBER 


* 

t 

LOCATION 

OPERATION 

CODE 

OPERANDS 


^ 2 3 4l 5 

6 

7 

8 . i . . 14 

15 1 . . . .20 



1 

■ 1 

L 


qny,+aq 

MFT£M 

paranvrt’eir'dii ■,•••■ parcmKtt'am . 


Ti 



7 




■ i.i 

: 



, 



ii 




i 


-i t-J t L — 1 1— J 1 l— . . L-. 1 


Table 4-6 provides the description of the Fetch macro parameters. 
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Table 4-6. Description of Fetch Macro Parameters 


Parameter 

Number 

Value 

00 

Any tag in the location field. Simply stated, this tag is the entrance 
point to which the user branches to initiate the Fetch. This parameter 
is required. 

01 

Two -character prefix applied to all symbols in the Fetch macro 
routine. This parameter is required. 

02 

Address for own-code exit (file open) when the Fetch macro rou- 
tine has been fully specialized (symbolic tag or decimal address). 
This parameter is optional. 

03 

Address for own-code exit for sort-item examination (a symbolic 
tag or decimal address). This parameter is optional. 

04 

Address for own-code exit far source-item examination (sym- 
bolic tag or decimal address). This parameter is optional; how- 
ever, at least one of the exits specified by parameters 03 and 04 
must be specified. If this exit is to be utilized, the sort-item 
format specified to the preceding sort must include the source- 
item address. 

05 

Address for own-code exit when the end of the sort-item file is 
reached (symbolic tag or decimal address). This parameter is 
required. 

06 

Address of own-code exit for uncorrectable read error on sort-item 
file (symbolic tag or decimal address). This parameter is optional. 

07 

Address of own-code exit for uncorrectable read error on source-item 
file (symbolic tag or decimal address). This parameter is optional. 

08 

Buffer size required for reading blocks from the sort-item file (up to four 
decimal characters). Refer to OS in Appendix A. The default value is 1,250. 

09 

Buffer mode for reading sort-item file: 

SINGLE - Single buffering. 
DOUBLE - Double buffering. 

The default value is "DOUBLE." 

10 

Index register used for sort-item file (one decimal character in 
the range from one to four). This index register will contain the 
address of the high-order character of the sort item at the own- 
code exit for each sort item. This parameter is required, be- 
cause at least one of the two examination exits must be specified, 
and this parameter is used as a default value if parameter 13 is 
not written. 

11 

Buffer size required for reading blocks from the source-item file 
(up to four decimal characters). Refer to INB on page 4-43. The 
default value is 1, 250. 

; 12 

Buffering mode for reading source -item file: 

SINGLE - Single buffering. 

DOUBLE - Double buffering. 

The default value is "DOUBLE." 
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Table 4-6 (cont). Description of Fetch Macro Parameters 


Parameter 

Number 

Value 

13 

Index register used for source -item file (one decimal character 
in the range from one to four). This index register will contain 
the address of the high-order character of the source item at the 
own-code exit for each source item. The default value is the same 
index register as that specified by parameter 10. 

14 

Reserved for future use. 

15 

The address of a constant (DCW) in the user's program contain- 
ing the name of the work file which holds the sort-item file input 
to the Fetch macro routine (symbolic tag or decimal address). 

The DCW must be ten characters long. When more than one work 
file is specified to the preceding sort, the name defined by the 
DCW must be that of the last work file of those specified. The 
default value is that the work file name is "*SORTWORK. " 

16 

The address of a constant (DCW) in the user's program contain- 
ing the device address of the device on which the work file named 
in parameter 15 can be found (symbolic tag or decimal address). 
The DCW must be two characters in length and contain the device 
address in exactly the same form it would appear in a PDT in- 
struction. The default value is pcu 04, drive number 0. 

17 

A single alphanumeric character (non blank) that is the unique 
suffix to all tags in an MPIOC not called by this version of Fetch. 
If parameter 17 is blank. Fetch is used to issue a call for MPIOC. 

18 

Fetch operates in the partial processing mode if the value of this 
parameter is "P. " Any other value results in normal mode pro- 
cessing. 

If the application of the Fetch macro routine is such that the 
examination of the sort item leads to bypassing of the source - 
item exit at least half of the time, then the partial processing 
mode saves processing time. 


Programmer's Preparation Information for Using the Fetch Macro Routine 
FETCH MACRO EXITS 

Linkage between the user's program and any specialized version of Fetch that is embedded 
in the program is effected through Fetch exits. These exits are addresses in the user's program 
to which Fetch branches when it executes the function associated with a particular exit. (The 
addresses are specified through the parameters of the Fetch macro statement.) The two prin- 
cipal exits are: 

1. Examine sort item; and 

2. Examine source item (mass storage resident). 
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Examine Sort Item 

When Fetch branches to the "sort-item" exit, a sort item has been brought into main 
memory, and the address of the left end of that item is available to the user through an index 
register that he has selected. The user may process that sort item and then return to Fetch 
to execute another request. Two returns are available: normal return and delete return. No 
punctuation is present in the sort item. 

NORMAL RETURN: If the user wishes to access the mass-storage-resident source item that 
is associated with the current sort item, he executes a "normal return." This is done by 
branching to a location whose address was found in the contents of the B-address register when 
the "sort-item" exit was made. Fetch will then return to the user's program through the source 
item exit with the main memory address of the requested item stored in a user-designated index 
register. However, if the source-item exit parameter was not specified to the Fetch macro 
routine, the next exit from Fetch will be effected through the sort item exit with the main 
memory address of the next logically sequential sort item. A source-item exit should not be 
specified if the source file is on 1 /2-inch magnetic tape or cards. 

DELETE RETURN: This return has meaning only if a source-item exit has been specified. 

When this return is used, it is assumed that the user is not interested in the source item 
associated with the current sort item. Therefore, the next exit from Fetch will be through the 
"sort-item" exit with the main memory address of the next logically sequential sort item. 

The address of the "delete return" is equal to the "normal return" plus a constant equal to 
the length of the address mode plus one. 

Examine Source Item 

Fetch branches to the source-item exit when a mass-storage-resident source item is 
available in main memory. The main memory address of that item is given through a user- 
specified index register. Input items are at the disposal of the user and are presented in the 
sequential order of a particular sort application. After the user has processed an item, the re- 
turn to Fetch is made by using the "normal return, " as described above. No punctuation is 
present in the source item. 

SUMMARY OF FETCH MACRO EXITS 

There are two sets of exits: normal processing and error promoted. 

1. Normal-Processing Exits 

a. File open (optional), normal return. 

b. Examine sort item (optional). 
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(1) Normal return. 

(2) Delete return — inhibits the user's access to an associated 
mass storage resident source item where the "examine 
source item" is active. 

c. Examine source item (optional), normal return. 

d. End of Fetch processing (mandatory); no return is permitted. 

2. Error -Promoted Exits 

a. Uncorrectable read error on sort-item file (optional). 

b. Uncorrectable read error on source-item file (optional). 

Although the "examine sort-item" and "examine source -item" exits are classified as 
optional. Fetch requires that at least one of them be active. 

MEMORY CONSIDERATIONS FOR USING THE FETCH MACRO ROUTINE 

The maximum memory requirements for the Fetch macro routine, excluding requirements 
for buffer space and the Supervisor, is 5, 500 locations. This requirement is reduced if all the 
options of the Fetch are not used, e.g., when no source-item examination exit is specified. The 
buffer space requirements depend upon parameter values; these values are discussed in the fol- 
lowing paragraphs. 

Examine Sort Item Only 

If parameter 04 is blank, only the examine sort -item exit is specified. Single buffering is 
specified if parameter 09 is "SINGLE. " In this case, buffer space = OS + 3, where OS is the 
sort -item block size. Double buffering is specified if parameter 09 is "DOUBLE" or if it is 
blank. In this case, buffer space = 2 (OS + 3). 

Examine Source Item Only 

If parameter 03 is blank, only the examine source-item exit is specified. Single buffering 
is specified if parameter 12 is "SINGLE. " In this case, buffer space = (OS) + INB + 6, where 
INB is the source-item block size. Double buffering is specified if parameter 12 is "DOUBLE" 
or if the parameter value is left blank. In this case, buffer space = 2 (OS) + 2 (INB) + 12. 

Both Source-Item and Sort-Item Exits Specified 

When both the source-item and sort -item exits are specified, either file may be associated 
with single or double buffering. As a general rule, if there is a memory restriction, it is more 
advantageous to use single buffering for the sort item and double buffering for the source item. 
The following considerations apply. 

1. If "SINGLE" is specified for both source-item and sort-item files, 
the buffer space required is OS + INB + 6. 
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2. If "DOUBLE" is specified for both source-item and sort-item files, the 
buffer space size required is 2 (OS + INB + 6). 

3. If "SINGLE" (parameter 09) is specified for the sort-item file and 
"DOUBLE" (parameter 12) for the source-item file, the buffer space 
required is OS + 2 (INB) + 9. 

4. If "DOUBLE" (parameter 09) is specified for the sort-item file and 
"SINGLE" (parameter 12) for the source-item file, the buffer space 
required is 2 (OS) + INB + 9. 


Initiation of Fetch Macro Routine 

The Fetch macro routine is initiated by branching to the tagged location specified in the 
location field (parameter 00) of the Fetch macro call. 


Use of Physical 1/ O C Program by Fetch Macro Routine 

The user of the Fetch macro routine has a choice in using the Physical I/O C program. He 
can use the Physical I/O C that can be incorporated (see parameter 17 in Table 4-6) in the 
Fetch macro routine, or he can have the Fetch macro routine use the Physical I/O C that is in- 
corporated in the user's own-coding. This is illustrated in Figure 4-13. 



User's Own-Code 
Program Uses the 
Physical I/O C of 
the Fetch Macro 
R outine . 



The Fetch Macro Routine 
Uses the Physical I/O C 
of the User's Own-Code 
Program. 


Figure 4-13. Use of Physical I/O C by Fetch Macro Routine 


In either case, the user should remember the requirements of Fetch for using Physical 
I/O C. Specifically, Fetch requires that parameter 04 of the MPIOC call be equal to "M" to per- 
mit control over more than one peripheral control unit. Parameters 02 and 05 should be blank. 
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In addition, the user may have more than one Fetch macro routine in a given program. 

The two methods of using Physical I/O C and the multiple occurrence of the Fetch macro routine 
in a given program are discussed in the following paragraphs. 


OWN-CODE PROGRAM USES PHYSICAL I/O C OF FETCH MACRO ROUTINE 

The Fetch macro routine incorporates Physical I/O C automatically if parameter 17 of the 
macro call for Fetch is blank. If the user intends to use Logical I/O C or to use Physical I/O C 
directly in his own-coding, he should use Physical I/O C as provided by the Fetch macro routine. 
The following points should be noted. 

1. The MPIOC suffix associated with Physical I/O C when called by the Fetch 
macro routine is % (+, 8, 5 keypunch). This parameter must be supplied to 
Logical I/O C or to the Physical I/O C that the own-code program uses. 

2. The file tag used by Physical I/O C when called by the Fetch macro routine 
is the value of the parameter 01 of the Fetch macro call. The user should 
not use tags beginning with this file tag in his own-code. If Logical I/O C 
or Physical I/O C is used in an own-code program, this same file tag 
should not be assigned to these input/output routines. 


FETCH MACRO ROUTINE USES PHYSICAL I/O C OF OWN-CODE PROGRAM 

If parameter 17 of the macro call to the Fetch is not blank, the Fetch macro uses the 
Physical I/O C supplied within the user's own-code program. The value of parameter 17 is the 
MPIOC suffix associated with that particular Physical I/O C. The following considerations 
should be noted. 

1. The MPIOC suffix supplied to the Physical I/O C that Fetch is to use 
must be the value of parameter 17 of the Fetch macro call. 

2. The file tag supplied in parameter 01 of the 'Fetch macro call must be 
different from any file tag that is used with Logical I/O C or Physical 
I/O C in the own-code program. 


MULTIPLE OCCURRENCE OF FETCH MACRO ROUTINE IN PROGRAM 

If the user desires to have more than one Fetch macro routine in a single program, this 
can be accomplished either with Physical I/O C being called by the Fetch macro or with the 
Fetch macro routine using Physical I/O C as supplied by the user's own-code program. The 
following considerations apply. 

1. If Physical I/O C is to be called by Fetch, the first macro call for Fetch 
must leave parameter 17 blank, and all other calls for Fetch must specify 
"%" for parameter 17. 

2. If Fetch is to use the Physical I/O C supplied with the own-code program, 
then every call for the Fetch macro routine must specify the value of pa- 
rameter 17 as the suffix associated with the MPIOC to be used by the Fetch 
macro routine. 
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In both cases described above, each call for the Fetch routine must specify a different 
value for parameter 01 (the Physical I/O C file tag). 

PARTIAL PROCESSING 

If the Fetch macro routine has been specialized for the partial processing mode (parameter 
18 is "P"), the buffering modes for the sort-item file and the source-item file are both single. 

The Fetch macro routine ignores the values of parameters 9 and 12 and in both instances, single 
buffering is forced. Partial processing should only be used if examination of the sort item 
leads to a limited accessing of the source-item file. 

DELAYED EXECUTION 

If the Fetch macro routine is not used immediately following the sort, it is essential upon 
execution of the program containing the Fetch routine that the source -item file and the work files 
have the same assignments that were given to them at the beginning of the sort. 

DETAILED DESCRIPTION OF SEQUENTIAL OUTPUT FILE PROGRAM 

Job Control Language for Sequential Output File Program 

Requesting the creation of a sequential output file through a separate Execute statement 
(with parameters submitted by means of other job control statements) allows the use of own- 
coding during the operation of the sequential output file program. Own-coding is not available if 
the sort calls for the sequential output file program through the inclusion of the File statement for 
the output file. 

The following paragraphs describe the job control language when the sequential output file 
program is called through its own Execute statement. The job control language for the case 
where the sequential output file program is called by the sort is described in this section under 
"Job Control Language for Mass Storage Sort C. " 

Execute Statement 

An Execute statement is necessary to call the sequential output file program. This Exe- 
cute statement must have "#MSEQFS0" in the operands field. 

Sequential Output Statement 

The Sequential Output statement is required. The format of this statement is shown in 
Figure 4-14. 
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EASYCODER 

C00M6 FORM 
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Figure 4-14. Sequential Output File Program Statement and Parameter 


HIGH-MEMORY-ADDRESS PARAMETER 

The high-memory-address parameter (HMA) defines the highest memory address available 
to the sequential output file program. If an own-code program is resident during the program 
and the base address of that program is lower than that specified for the HMA parameter, then 
the base address (lower exit address) of that program less one is taken as being the highest 
memory address available for the execution of the sequential output file program. The form of 


this parameter is shown below. 


HMA 


high-address 

nnM 


high-address - The highest address available, written as a decimal number (up to 
six characters in length). 


nn M - The number of memory modules (M) available, written as a 2- 

character decimal number. The highest address available is com- 
puted by the sequential output file program and is one less than nn 
times 4, 096. "M" is a parameter constant. 


The default assumption is that the HMA value is to be taken from the Supervisor communi- 
cation area field that specifies the highest memory address available to the object program. If 
HMA is specified but has a higher value than the address in the Supervisor, the Supervisor value 
is used. 


File Statements 

The File statements specify information about the input and output files used by the sequen- 
tial output file program. The format of the File statements is shown in Figure 4-15. 
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Figure 4-15. File Statement and Parameters for Output File 


OUTPUT FILE 

A sequential file is the output of the sequential output file program. The parameter "OUT" 
identifies a File statement as referring to an output file. This statement is required. 


Name Parameter 

The name parameter (NAME) specifies the file name of the output file. It has the following 

form. 

j NAME = file -name, 

file -name - The file -name of the output file (up to ten characters in length). 

Trailing spaces are added. 

For mass storage, the file-name is the name of the output file and is a required parameter. 
For magnetic tape, if the output file has standard labels, this file-name should be given to the 
file. The output file-name is blank if this parameter is not specified. 

Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical device address(es) of the 
volume(s) containing the output file. It has the following format. 

^DEVADD = (pcu, drive), | ... 

pcu - The peripheral address assignment of the control unit (two octal charac- 
ters). The high-order (I/O) bit is not relevant, but all other bits must 
be specified. 


drive - Drive number (one octal character). 
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For mass storage, an output file may be contained on more than one volume, up to a maxi- 
mum of eight. The default assumption is pcu 04, drive 0, and that the file is contained within 
one volume. 

For magnetic tape, no more than two devices may be specified, and both devices must have 
the same pcu number. The default assumption is pcu 00, device 1. 

Password Parameter 

The password parameter (PW) defines the password of the sequential output file. It has the 
following format. 

PW = password, 

password - The output file password (up to eight characters). Trailing spaces are added. 
The default assumption is that the file is not protected by a password. 

Device-Type Parameter 

The device-type parameter (DEVTYPE) specifies the storage medium to be used for the 
output file, and it has the following format. 

DEVTYPE = device -type, 

device -type - The type number of the device used for storing the output file or 
the general name of that device. The device type may be 204B or 
TAPE. 

The default assumption is mass storage (device type codes for mass storage are not used). 
Parity Parameter 

The parity parameter (PAR) specifies the parity of recording for a magnetic tape file and 
has the following format. 

PAR ° (gyL? ■ 

ODD - Odd parity. 

EVEN - Even parity. 

The default value is ODD. 
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Banner Parameter 

The banner parameter (BAN) specifies information concerning the banner character, and 
it has the following format: 



banner 


BAN = 

YES 

. NO . 

) 


A banner character is to be the first character of every record (speci- 
fied as two octal digits). 

A banner character of 56 octal is to be the first character of every record. 
No banner is required. 


banner - 

YES - 
NO 


The default assumption is YES. Specifying the banner parameter has no significance if the 
output file is to reside on mass storage. 


Label Parameter 

The label parameter (LABELS) specifies whether the magnetic tape file is to have standard 
labels or no labels. The parameter has the following format. 



YES - The file has standard labels. 

NO - The file has no labels and is terminated by a tape mark. 

The default assumption is standard labels. 

Tape-Mark Parameter 

The tape-mark parameter (TM) describes the tape-mark requirement when standard labels 
are requested. 

™° {;}• 

1 - A tape mark precedes the standard trailer. 

2_ - A tape mark follows the standard header and precedes the standard trailer. 


The default assumption is that tape marks are not required with standard labels. The 
tape-mark parameter is ignored if labels are absent. All tape marks will be written in even 
parity marks. 
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Record-Length Parameter 

The record-length parameter (REC) indicates the number of characters in each record of 
the output file. It is of the following form: 

REC = record-length, 

record-length - The number of characters in each record of the file including a 

banner character when applicable (up to four decimal characters). 

This parameter is significant only if the output file is on magnetic tape. 

Padding Character Parameter 

The padding character parameter (PAD) specifies a padding character for a magnetic tape 
file, and it has the following format. 

| PAD = padding, 

padding - Padding character expressed as two octal digits. 

For an odd parity file, the default value is 77g; for an even parity file, the default value i s llg. 
WORK FILE 

A work file is a file in which the preceding sort used a work area on mass storage which 
was defined by work file parameters to that sort. A parameter record essential to the execution 
of the sequential output file program has been written in the mass storage area allocated to the 
last work file specified to the preceding sort. The name of this work file, therefore, is required 
by the sequential output file program, together with the device associated with the last volume 
of the work file. 

The parameter "WORK<n>" identifies the file statement as referring to a work file (see 
Figure 4-16). 

If no File statement appears for the work file, the default assumption is that only one work 
file was specified to the sort; its name is "*SORTWORK, " and it is assigned device address pcu 
04, drive 0. If the file statement is given, it is not necessary that the "n" of WORK<n> be 
specified. 
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Figure 4-16. File Statement and Parameters for Work File 


Name Parameter 

The name parameter (NAME) specifies the file name of the last work file. This parameter 
is required. It has the following form. 

NAME = file -name, 

file -name - The file-name of the work file (up to 10 characters in length). Trail- 
ing spaces are added. 

The default assumption is *SORTWORK. 

Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical device address of the last 
volume of the last work file. This parameter has the following form. 

| DEVADD -- (pcu, drive). 


pcu - The peripheral address assignment of the control unit (two octal charac- 
ters). The high-order (I/O) bit is not relevant, but all other bits must be 
specified. 

drive - Drive number (one octal character). 


The default assumption is pcu 04, drive 0. 


INFORMATION FILE 

The information file is a printed program history. The parameter "INFO" identifies a file 
as referring to the information file (see Figure 4-17). 


If no File statement for the information file appears, the default assumption is that a pro- 
gram history is not required. 
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EASYCODER 

COOING FORM 

PROBLEM PROGRAMMER DATE RAGE OF 


CARO 

NUMBER 

H 

IE 

OPERATION 

CODE 

OPERANDS 


uuuuH 

□E 

2DMHHHHHI] 

15, . , .20 



warn 

II 

IIM 



Cyftonal . , . . 

HI 


\mm 

TjgH 


Optional . , 

znr 

II 

iwmmm 

HI 1 


MmmuHmi 


Figure 4-17. File Statement and Parameters for Inf ormation File 


Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical device address of the infor- 
mation file. The information file must be on the printer. The device-address parameter has 
the following form. 

| DEVADD = (pcu), 

pcu - The peripheral address assignment of the control unit (two octal characters). 

The default assumption is pcu 02. 


Exits Statement 

The Exits statement (see Figure 4-18) specifies own-code exits from the sequential output 
file program to user routines. There are no own-coding exits if the Exits statement is omitted. 
For proper programming procedures, refer to the heading "Programmer’s Preparation Infor- 
mation for Sequential Output File Program, " in this section. 
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Figure 4-18. Exits Statement and Parameters 


OPEN PARAMETER 

If the output file is on a mass storage device, the open parameter (OPEN) specifies an 
own-code exit that permits the user to have access to the item in the file description index 
pertinent to the output file. If the output file is to be created on 1 /2-inch tape with standard 
labels, the open parameter specifies an own-code exit that permits the user to access the labels 
before they are written on tape. 
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j OPEN = address, 

address - The address to which the sequential output file program will branch (up 
to six decimal digits). 

The default assumption is that there is no OPEN exit. 

ITEM PARAMETER 

The item parameter (ITEM) specifies an own-code exit that occurs for every sort item 
until the user terminates the function. The default assumption is that there is no exit. The form 
of this parameter is shown below. 

| ITEM = address, 

address - The address to which the sequential output file program will branch 
(up to six decimal digits). 

PROGRAM NAME PARAMETER 

The program name parameter (PROG) specifies that a named program is to be loaded for 
the item and open own-code exits. This parameter has the following form. 

j PROG = program-segment-name, 

program- segment -name - The program segment name of the program to be loaded. 

The default assumption is that the own-code program was resident in main memory before 
the sequential output file program was loaded. 

VISIBILITY PARAMETER 

The visibility parameter (VIS) specifies the visibility mask of the own-code program. 

This parameter has the following form. 

I VIS = visibility-mask, 

visibility-mask - The 6 -character visibility mask to be used in loading the own -code program. 
The default assumption is that visibility is not used. 

Job Control Language Examples for Sequential Output File Program 
EXAMPLE 1 

This example illustrates a call for a sort followed by a request to create a sequential out- 
put file based on output from that sort. The work -file information corresponds to that defined 
for the last volume available to the sort for a work area. Own-coding is requested during the 
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creation of the output file, and the own-code program is to be called by the sequential output 
program. 
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EXAMPLE 2 

This example illustrates a call for a sort followed by a request to create a file on 1 /2-inch 
tape. The work file is "*SORTWORK" located at pcu 04, drive 0. Input to the sort is on tape. 
Items are blocked two per record; the tape format is bannered, standard labels with odd parity. 
The output file is to contain sort items. The format of the output tape is unbannered, standard 
labels with even parity. Items are blocked two, and a tape mark precedes the trailer. The in- 
put tape labels are updated and used as output labels. The user may inspect (and modify) the 
labels for the output tape through own-coding. 
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Programmer's Preparation Information for Sequential Output File Program 


FILE ALLOCATION 

When the output is to be on mass storage, the sequential output file must be allocated prior 
to the execution of the sequential output file program. It must be organized as a sequential file. 
It is also necessary that compatibility exist between the description of the file and the data that 
is to be handled by the program. If some incompatibility should exist, the output file will not be 
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created. An example of such incompatibility is the case where the item size of the sequential 
output file is not the same as that of the source file (assuming that an item sort has been requested). 

SPECIFYING WORK FILE 

When the sequential output file program is called through an Execute statement, the work 
file name that must be specified is the same as that of the last work file used by the preceding 
sort. Furthermore, the device address must be that of the last volume of that work file. 

MEMORY REQUIREMENTS FOR SEQUENTIAL OUTPUT FILE PROGRAM 

The memory requirements for the execution of the sequential output file program depend 
upon whether the items come from the sort-item file or the source -item file. 

Output File from Sort Items 

When the preceding sort application was an item sort (EXTR = ITEM) or the application 
was such that no item address was appended to the sort item (ITADD = NO), it is assumed that 
the item of the output file is to have the same format as the sort item. Therefore, the original 
input items will not be accessed and no allowance need be made for buffers for the source file. 


Output File from Source Items 

If the preceding sort application was not an item sort and an item address was appended to 
the sort item, it is assumed that the items that form the output file are to come from a mass- 
storage-resident source file (the input file to the sort). In this instance, a buffer is required for 
a source block. In addition, it is desirable to allow as much memory space as possible for an 
intermediate item- storage area. 


Calculation of Memory Requirements for Sequential Output File Program 

When calculating the memory requirements for the sequential output file program, two 
formulas are used: one when the sort item is used, and one when the source item is used: 

1. Sort item used for the sequential output file program - the minimum 
memory requirement = PROG + SUP + OS + OBUF + SIS + TYPE. 

2. Source item used for the sequential output file program - the minimum 
memory requirement = PROG + SUP + OS + OBUF + INB +IL + 20 + TYPE. 

The definitions of the terms in the above formulas follow: 

PROG = 7100, 

SUP = Size of Supervisor + 200 (see Supervisor manual), 

OS = Sort -item block size (see Appendix A), 

OBUF = Output block size, 

INB = Source-block size (input file to the sort). 
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SIS = Sort-item size, 

IL = Source-item size (input-item), and 

TYPE = 2000, only if typewriter is used. 

Highest Memory Location Available to the Sequential Output File Program 

The highest memory location available to the sequential output file program (HMSQ) is not 
always equal to the value the user specifies for the highest memory location (HMA). If own- 
coding is not present, then HMSQ = HMA. If own-coding is present and the address values 
(OPEN and ITEM) are greater than the highest memory address parameter or lie below the base 
of the sequential output file program, then HMSQ = HMA. (Own-coding can only lie below the 
base of the sequential output file program if this program has been relocated from its present 
base value of 200 decimal. ) If the address values lie below the user -specified highest memory 
address parameter, then HMSQ = OPEN-1, if the OPEN value is less than the ITEM value; 
otherwise, HMSQ = ITEM - 1. 

OWN-CODING FOR SEQUENTIAL OUTPUT FILE PROGRAM 

There are no own-coding exits from the sequential output file program if the program was 
called by the inclusion of the output File statement among the job control statements for the sort. 
When the sequential output file program is requested through an Execute statement, however, the 
own-coding functions described below may be performed. It is important that all own-coding 
routines which modify index registers XI, X2, X3, and X4 restore them prior to returning con- 
trol to the sequential output file program, with the exception of index register XI when an item is 
being added. 

Open Exit Own- Coding 

MASS STORAGE OUTPUT: The sequential output file program branches to the location specified 
by the value of the open parameter when it has read the item in the file description index 
(*VOLDESCR*) for the sequential output file. There is the option not to exit to the open own- 
code program for every volume of a multivolume sequential file. 

Index register XI contains the address of the left (high- order) end of the file description 
index item. If the accessing of the sequential output file requires specifying the password param- 
eter, the item is not made available until the requirement has been met. Principally, the item 
is made available for inspection and it may be moved to the own-code program area. No 
punctuation is available in the area it occupies. If the own-code program sets punctuation in 
that area, it is responsible for clearing that punctuation before returning control to the sequential 
output file program. 


4-70 


#3-619 


SECTION IV. MASS STORAGE SORT C 


If open exit own-coding is to be executed for successive volumes of the file, the sequential 
output file program is reentered at the location defined by the contents of the B-address register 
when the sequential output file program branched to the own-code routine. Open exit own-coding 
may be terminated after any volume by branching to a location whose address is formed by adding 
a branchspace constant to the normal address. A Store Control Register (SCR) instruction to the 
B-address register should be the first instruction of the open exit own-coding. 

TAPE OUTPUT: The sequential output file program branches to the location specified by the 
value of the OPEN parameter when it has read a header from the output tape and updated char- 
acters 41-80 of the header as required (that is, duplicated characters 41-8 0 of the input tape 
header or duplicated characters 41-80 of the dummy header). Index register XI contains the 
address of the leftmost (high-order) end of the label. The label is made available for inspection 
and modification. 

The own-code program may alter characters 41-80 only. A word mark is present on the 
left end of the sort area occupied by the label. If the own-code program sets other punctuation 
in the sort area, the program should clear that punctuation prior to returning control to the sort. 

Similarly, the sequential output file program branches to the location specified by the value 
of the OPEN parameter when an end-of-reel or end-of-file trailer has been produced. Charac- 
ters 31-80 are updated as the application requires. They may be altered through user own- 
coding. An item mark is present on the location specified by an open address + 1 to indicate that 
the label is a trailer. Index register XI contains the address of the leftmost (high-order) end of 
the label. Punctuation procedures followed by the own-code program are identical to those used 
when the label is a header. 

If open own-coding is to be continued for successive labels of the file, the sequential out- 
put file program is reentered at the location defined by the contents of the B-address register 
when the own-code routine was entered. Open own-coding may be terminated after any label has 
been accessed by branching to a location whose address is formed by adding a branchspace con- 
stant to the normal address. A Store Control Register (SCR) instruction of the B-address regi- 
ster should be the first instruction of the open own-code routine. 

Item Exit Own-Coding 

The item exit own-coding options that may be exercised depend upon whether the sequential 
output file program is being created from source items or sort items. 
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If item exit own-coding is active, a branch is made to the location whose address is speci- 
fied by. the own-code parameter. Index register XI contains the address of the left (high-order) 
end of the current sort item. The only punctuation present in the sort item is a word mark in 
the high-order character of the item (see Figure 4-19). 



Figure 4-19. Item Punctuation for Sequential Output File Program 


The four options in item exit own-coding are listed below and described under separate 
headings, e. g. : 

1. Modifying an item; 

2. Adding an item; 

3. Deleting an item; and 

4. Terminating item exit own-coding. 



MODIFYING AN ITEM: The conditions for modifying an item depend upon whether the item used 
for output is a sort item or a source item, as described below. 

1. If a sort item is used for output, the contents of the sort item may be 

modified, but its length and punctuation cannot be changed. After modi- 
fication, the user makes a normal return to the sequential output file 
program. 
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2. If a source item is used for output, modification of the sort item has no 
meaning, since the item that is passed to the sequential output file is the 
source item associated with the current sort item. If the user wishes to 
modify the original input items, the Fetch macro routine should be used 
instead of the sequential output file program. 


ADDING AN ITEM: The conditions for adding an item depend upon whether the item used for 
output is a sort item or a source item, as described below. 

1. If the sort item is used for output, an item having the same format as the 
sort-item may be added to the sequential output file program by placing 
the address of the left (high-order) character of the item in index register 
XI. A word mark must be present in that high-order character (refer to 
"Add an Item" in Figure 4-19). The item precedes the current sort item in 
the output file. Control is returned to the sequential output file program 
by branching to a location whose address is formed by adding a branch- 
space constant to the normal return address. 

2. If a source item is used for output, an item having the same format as a 
source item may be added by placing the address of the left (high-order) 
end of such an item in index register XI. A word mark must be present in 
the high-order character of the item. The item that is added precedes the 
source item associated with the current sort item in the sequential output 
file program. Control is returned to the sequential output file program by 
branching to a location whose address is formed by adding a branchspace 
constant to the normal return address. 


DELETING AN ITEM: The conditions for deleting an item depend upon whether the item used for 
output is a sort item or a source item, as described below. 

1. If a sort item is used for output, the sequential output file program is re- 
entered by adding two branchspace constants to the normal return address, 
provided, that after inspecting the sort item, it is intended to delete that 
item as a member of the sequential output file program. 

2. If a source item is used for output, the sequential output file program is 
reentered by adding two branchspace constants to the normal return address, 

provided, that after inspecting a sort item, it is intended that the 
associated source item should not be included in the sequential output 
file program. 


TERMINATING ITEM EXIT OWN-CODING: When all item own-coding processing has been com- 
pleted, the own-coding routine must branch to a location whose address is obtained by adding 
three branchspace constants to the normal return address. 

An item mark in the location specified by the own-coding address indicates that the sequen- 
tial output file program has processed all its input. If, at this point, more items are to be added, 
the own-code program follows the above procedure specified for adding an item. The sequential 
output file program continues to exit to the own-code program until the terminated own-coding 
return or a normal return is made. 
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OUTPUT TAPE LABELS 
Dummy Labels 

The paragraphs under "Sequential Output File Program Input/Output Files, " in this section, 
indicate the applications for which dummy labels are created for the output file. Tables 4-7 and 
4-8 list the formats for dummy labels. 


Table 4-7. Format for Dummy Header 


Characters 

Contents 

Comment 

1-5 

01 30 24 51 15 

1HDRA 

6-10 

ttttt 

Tape reel identification: alpha- 
numeric (preserved from output 
reel). 

11-15 

blanks 


16 

57 or 40 

hyphen: if even parity 
minus: if odd parity 

17-19 

sss 

Reel sequence number: decimal. 

20 

blank 


21-30 

fffff fffff 

File name: 10 alphanumeric 
characters. In a dummy header, 
characters 21-30 are blank un- 
less a name is specified through 
the output file statement. 

31-35 

yyddd 

Creation date obtained from the 
relevant field of the Supervisor. 

36 

57 or 40 

hyphen: if even parity 
minus: if odd parity 

37-39 

ggg 

Retention cycle - 0. 

40-80 


Blanks 


Other Labels 

The paragraphs under "Sequential Output File Program Input/Output Files" in this section 
indicate the applications for which input tape labels are updated and used as labels for the output 
file. The first header of the input file and the last trailer (1EOFA) form the basis for the cre- 
ation of the output file labels. Input tape header characters 1-36 (see comments in Table 4-7 for 
a description of the fields involved) are updated for the output file header label. The retention 
cycle for the input tape file is preserved and appears in the output file header labels in characters 
37-39. Characters 41-80 are left undisturbed by the sequential output file program, but they may 
be altered through own-coding. 
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Table 4-8. Format for Dummy Trailer 


Characters 

Contents 

Comment 

1-5 

01 25 46 51 15 

IE ORA 


01 25 46 26 15 

1EORA 

6-10 

rrrrr 

Number of data records in this 
file, decimal. Not accumulated 
from one reel to the next. 

11-20 

mu 11111 

Number of items processed, 
decimal. Accumulated for ban- 
nered file only. 

21-30 

fffff fffff 

Filename: 1 0 alphanumeric 
characters. In a dummy trailer, 
characters 21-30 are blank unless 
a name is specified through the 
output file statement. 

31-80 

blanks 



Input tape trailer characters 1-30 (see comments in Table 4-8 for a description of the 
fields involved) are updated for the output file trailer labels. Characters 31-80 are undisturbed 
by the sequential file program, but they can be altered through own- coding. 


OPERATING PROCEDURES FOR MASS STORAGE SORT C 


Loading and Executing 

Job control information can be given to the sort in two ways. 

1. The sort parameters are given as statements in the job control file (which 
must be in the card reader). 

2. The sort parameters are resident in memory through some previous user 
action. 


When the sort parameters are given as statements in the job control file, the statements 

containing the parameters are preceded by an Execute statement. "#SORT3PO" is the required 

program- segment name to call Mass Storage Sort C. When the parameters are resident in 

memory through some previous user action, an Execute statement is the only statement required 

in the job control file. "*SORT3Pl" is the program-segment name in this instance. 

NOTE: In either of the above cases, the sort can be called through a pro- 
grammed call to the Supervisor. In this case, no Execute statement 
is required. 

Loading the Fetch Macro Routine 

The Fetch macro routine is incorporated into the user's program. The loading of the user's 
program (including the Fetch macro routine) is performed in the normal manner for the operating 


7/15/70 


4-75 


#3-619 



SECTION IV. MASS STORAGE SORT C 


system being used. There are no job control statements for the Fetch macro routine. The Fetch 
routine and its parameters are discussed in detail in this section under "Language Elements of 
Fetch Macro Routine. " 

Loading Sequential Output File Program 

The sequential output file program can be loaded either directly by a preceding sort or 
separately by itself. 

LOADING SEQUENTIAL OUTPUT FILE PROGRAM BY SORT 

When the sort loads the sequential output file program automatically, loading procedures 
are the same as those for the sort, as previously described under "Loading and Executing. " Pa- 
rameters may be supplied either through job control statements or through main memory. 

LOADING SEQUENTIAL OUTPUT FILE PROGRAM SEPARATELY 

When the sequential output file program is loaded separately, parameters are entered 
through job control statements. The job control file for the sequential output file program con- 
sists of the following: 

1. Execute statement for program segment *MSEQFSO; and 

2. Job control statements for the particular application. 

Loading and Specializing Sort Phases 

Mass Storage Sort C is composed of three logical phases. The sort can be divided into 
three separate runs if the work files available to the sort are not disturbed. 

Delayed Execution of Sort 

Each of these three sort runs continues from the point at which the preceding run was ter- 
minated. All volumes of the work files must be mounted at the same addresses as for the pre- 
ceding run. 

DELAYED EXECUTION OF MERGE 1 -CYLINDER PHASE 

If the user wishes to delay running the 1 -cylinder phase, the Execute statement, which 
initiated Mass Storage Sort C by calling for "SORT3, " he should include the value "*MERG3M" 
for the HALT keyword parameter. When segment MO is loaded, it will not be executed. The 
values of decimal locations 201 through 209 should be saved. Their values should be reentered 
prior to the delayed execution of segment MO. The Execute statement to call for the 1 -cylinder 
phase of the sort must have the program-segment name "*MERG3M0. " 
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DELAYED EXECUTION OF MERGE MULTICYLINDER PHASE 

This procedure is the same as that described above for the 1 -cylinder phase, except 
that the HALT keyword parameter value is "*MERG3M3, " and the Execute statement for the de- 
layed execution must have the program-segment name "*MERG3M3. " 

Delayed Execution of Fetch Macro Routine 

The execution of the Fetch macro routine may be delayed as long as the mass -storage- 
resident source-item file (the input file to the sort), as well as the work files, are mounted prop- 
erly. The operation of the Fetch routine in this case is the same as that described in this section 
under "Loading the Fetch Macro Routine. " (If the Fetch routine does not refer to the source 
file, it need not be mounted during the sort. ) 

Delayed Execution of Sequential Output File Program 

The execution of the sequential output file program maybe delayed, provided that the 
mass-storage-resident source file and the work files are mounted as they were during the sort 
execution. Loading procedures are the same as described in this section under "Loading Se- 
quential Output File Program Separately. " (If the sequential output file program does not refer 
to the source file, then it need not be mounted during the execution of the program. ) 

Multivolume Processing 

The input file as discussed below is assumed to be mass storage resident. 

MULTIVOLUME PROCESSING DURING SORT EXECUTION 

During the entire sorting process, the work file must have all volumes online. The source- 
item file must be online if a key sort is being executed; i.e. , the source-item file must have 
all of its volumes mounted during the sort if there is to be a reaccessing of the source file during 
a Fetch or sequential output file process. However, if an extract or item sort is being per- 
formed, the number of volumes mounted for the source-item file may be the minimum number 
required for that file. For a sequential or direct access file there may be only one volume 
mounted, if desired. For indexed sequential files, there may be as few as one additional volume 
mounted at one time as long as the master /cylinder index and general overflow volume remain 
mounted throughout the run. 

MULTIVOLUME PROCESSING DURING FETCH EXECUTION 

During execution of the program containing a specialized version of Fetch, the work files 
specified for the sort must have all volumes online. Furthermore, those volumes must have 
the same device addresses as those assigned to them for the sort. 


4-77 


#3-619 


SECTION IV. MASS STORAGE SORT C 


If the application requires access to the original input file, as is necessary in a pure key 
sort, the volume of the source-item file must be on-line, and each volume must be assigned the 
same device address that it had during the sort. 

MULTIVOLUME PROCESSING DURING SEQUENTIAL OUTPUT FILE EXECUTION 

The work files specified to the sort must have all volumes on-line during the execution of 
the sequential output file program. Work file volumes must also be assigned the same device 
address as those assigned during sort execution. 

When the application of the sequential output file program requires access to the original 
input file, the source-item file must have all volumes mounted as they were during the sort. The 
volumes that contain the sequential output file may be mounted one at a time, if desired. 

Tape Positioning 
INPUT TO THE SORT 

The initial reel of a file must be positioned so that the first record to be read is the header 
of the file with standard labels, or the first data record of the file when no labels are present. 
This permits the processing of a multifile reel. Successive reels of a multireel file are re- 
wound prior to being opened. 

OUTPUT FROM THE SEQUENTIAL OUTPUT FILE PROGRAM 

The file is created from the beginning-of-tape, and each reel of the file is rewound prior 
to opening. 

File Protection 

The sort requires that the data write switch be set to PERMIT for the control unit contain- 
ing the work file. The sequential output file program requires that the data write switch be set 
to PERMIT for the control unit containing the sequential output file. In both cases, it is desir- 
able that the remaining three switches for the control unit be set to PROTECT. The sequential 
output file must not be a protected file. 

Operator Control 

Error conditons are indicated by either a halt, defined by the contents of the B-address 
register if the control panel is being used, or through typed messages if the console is being 
used. The operator takes corrective action and enters a response character through the control 
panel if one is being used, or he types the response character at the console keyboard if the type- 
writer is being used. 
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The mass storage sort, the Fetch, and the sequential output file program use the mass 
storage Physical I/O C. The sort and the sequential output file program also use Logical I/O C. 
Therefore, Physical I/O C and Logical I/O C halts (or messages) may appear in addition to those 
described in the paragraphs that follow. (Refer to the Data Management Subsystem manual for 
a description of the halts and messages not listed below. ) 

CONTROL PANEL ERROR HALTS 

The following paragraphs discuss the error halts that are defined by the contents of the B- 
address register. Such error halts can occur when the control panel is being used. 

Input/Output Error Conditions 

A B-address register value on the control panel in the range 0000-4777 indicates an input/ 
output error condition. 

PERIPHERAL DEVICE CONDITIONS: If the value in the B-address register is in the range 
0000 to 3777, the condition relates to a peripheral device. 

The general form of the B-address value is ppxd, 
pp = peripheral control unit, 
x = code indicating type of condition, 

0 = device not operable, 

1 = uncorrectable read error, 

2 = uncorrectable write error, 

3 = end of storage medium, 

4 = positioning or addressing error, 

7 = miscellaneous condition, and 

d = device number 

These values are consistent with the standard peripheral error halt codes. 

The operator should determine the peripheral control XX unit involved and then take appro- 
priate action. If the control unit is mass storage, the halt is executed by the Physical or Logi- 
cal I/O C of the Mod 1 (MSR) Operating System (refer to the Data Management Subsystem 
manual). If the control unit is for a device other than mass storage, the B-register values are 
listed in Table 4-9. 
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Table 4-9. Peripheral Error Halts for Mass Storage Sort C 


B-Address 

Register 

Cause 

Action 

ppll 

Uncorrectable card 
read error. 

Correct card and reposition it in reader. 
Enter a G (27g) into the location specified 
by the contents of the A-address register. 

If the card cannot be corrected, enter an E 
(25g) into the location specified by the con- 
tents of the A-address register. This will 
initiate a Supervisor search for the next job. 

ppld 

Uncorrectable mag- 
netic tape read 
error . 

The contents of the A-address register give 
the address of a location in memory into 
which a response character must be entered. 
Three response characters are valid: G(27g), 
A(21g), or E(25g). A G response causes 
the error record to be reread. An A 
response permits the error record to be 
bypassed. An E response initiates a search 
by the Supervisor for the next job. The 
entering of any other character causes an 
immediate return to the halt. 

pp2d 

Uncorrectable write 
error. 

The contents of the A-address register give 
the address of a location in memory into 
which the response character must be 
entered. Two response characters are 
valid: G(27g) or E(25g). A G response 
causes the record to be rewritten. An E 
response initiates a search by the Supervisor 
for the next job. The entering of any other 
character (causes an immediate return to 
the halt. 

Pp3d 

Halt for multireel 
input or output. 

This halt occurs whenever there is more 
than one input or output reel and no alter- 
nate tape drive specified. If an alternate 
drive is specified, the program does not 
halt but waits until the next reel is mounted. 

Mount the next reel on the drive in use for 
the file. The only valid response is G; 
this causes the program to continue. 


INPUT/OUTPUT FILE CONDITIONS: If the value of the B-address register is in the range 4000 
to 4777, the condition is related to logical operations with files (see Table 4-10). 


The general form of the value in the B-address register is 4xyd, 
d = device number. 
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If the value of the B -address register is not listed in Table 4-10, the condition is related 
to mass storage files. A list of mass storage B-address register values and their meanings 
can be found in the Data Management Subsystem manual. 


Table 4-10. Input/Output File Error Halts 


B-Address 
Regi ster 

A -Address 
List 

Cause 

Action 

406d 

Response field - one 
character. Specific 
code -one character 
(728). PPd - two char- 
acters. Filename -ten 
characters. 

Input reel record count- 
five characters 

Input reel record 
count incorrect. 

There are two valid response char- 
acters: A(21g) or E(25g). An A 
response allows the program to 
continue processing. An E 
response initiates a search for the 
next program. Any other response 
causes an immediate return to 
the halt. 

404d 

Response field - one 
character. Specific 
code - one character 
(03g). PPD - two char- 
acters. Filename-ten 
characters. 

1HDRA not found 
for input file. 
(Possible prob- 
lems are that the 
input tape is mis- 
positioned or that 
the wrong tape is 
mounted. ) 

There are two valid response char- 
acters: G(27g) and E(25g). A G 
response causes a new reel to be 
reopened but no repositioning is 
executed if the reel is the initial 
reel of the input file. An E re‘ 
sponse initiates a search by the 
Supervisor for the next job. Any 
other response causes an immedi- 
ate return to the halt. 

407d 

Response field - one 
character. Specific 
code-one character (13g). 
PPd - two characters. 
Filename-ten charac- 
ters. Input reel se- 
quence number - three 
characters. 

Reel sequence 
incorrect. 

There are three valid response 
characters: A(21g), E(25g), or 
G(27g). An A response causes the 
reel to be accepted and allows pro- 
cessing to continue. An E re- 
sponse initiates a search by the 
Supervisor for the next job. A G 
response causes a new reel to be 
reopened, but no repositioning is 
executed by the program if the reel 
is the initial reel of the input file. 
Any other response causes an 
immediate return to the halt. 

405d 

Response field - one 
character. Specific 
code -one character 
(71g). PPd-two char- 
acters. Filename - 
ten characters, 
yyddd- creation date- 
five characters. 

Retention cycle 
has not expired. 

There are three valid response 
characters: A(21g), E(25g), or 
G(27g). An A response causes the 
mounted reel to be accepted. A G 
response causes a newly mounted 
reel to be opened, and if the reel 
is accepted, processing continues. 
An E response initiates a search 
by the Supervisor for the next job. 
Any other response causes an 
immediate return to the halt. 
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Job Control File Error Conditions 

A B-address register value on the control panel in the range 5000-5077 indicates error 
conditions in the job control file that are common to the Mod 1 (MSR) Operating System (see 
Table 4-11). A B-address register value in the range 5040-5046 indicates that invalid param- 
eters have been fed to the sort, (Any corrective action for the latter assumes that the param- 
eters to the sort were put in the job control file and were not resident in memory when the sort 
was called. ) 

Table 4-11. Job Control File Error Conditions 


B-Address 

Register 

Cause 

5000 

Syntactic (grammatical) 
error, e. g. , a right 
parenthesis is missing. 

5001 

Statement not recognized. 

5002 

Invalid positional pa- 
rameter. 

5003 

Invalid keyword. 

5004 

Required parameter 
missing. 

5005 

Invalid parameter value. 

5010 

Invalid combination of 
parameters. 

5040 

Illegal parameter value. 
No further specification 
given. 

5041 

Invalid own-code address. 
Conflicts with sort mem- 
ory requirements. 

5042 

Insufficient memory 
space to execute the sort. 

5043 

Illegal parameter value 
for key and extract fields. 

5044 

Key and extract fields 
overlap or are incon- 
sistent with the item size. 

5045 

Error in the select and 
delete parameter values. 

5046 

Insufficient work file 
area. 


Action 


The contents of the A-address register give the 
address of a location in memory into which a 
response character must be entered. Two re- 
sponse character s are valid, G(27g) or E(25g). 
The entering of any other character causes an 
immediate return to the halt. If the error can 
be corrected, the set of job control statements 
should be refed (excluding the Execute state- 
ment) and the G response made. 

When the error cannot be corrected, an E 
response initiates a search by the Supervisor 
for the next job. 


The contents of the A-address register give the 
address of a location in memory into which the 
response character E must be placed. G 
or any other response value causes an im- 
mediate return to the halt. 

If the error can be corrected, the set of job con- 
trol statements preceded by the Execute state- 
ment (program-segment name *SORT3PO) should 
be refed and the E response made. 

When correction is not possible, the E response 
causes the Supervisor to search for the next job. 
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Program Specific Error Conditions 

A B -address register value in the range 6400-6477 indicates conditions specific to the sort, 
Fetch macro routine, and the sequential output file program. The corrective action that may 
be taken varies according to the halt. Therefore, a value in the A-address register gives the 
address of a list of information. These error conditions are listed in Table 4-12. 


Table 4-12. Program Specific Error Conditions 


B -Address 
Register 

A-Address 

List 

Cause 

Action - A = (2 1 8 ), G=(27 g ), E=(25 g ) 

6400 

Response field-one 
character. File 
name - ten charac- 
ters. 

Incorrect file name 
or input file not lo- 
cated. 

(1) Mass Storage Resident: 

If an incorrect file name has 
been given to the sort, the cor- 
rect name may be entered in 
file -name and the G re- 
sponse made. Otherwise, an E 
is the only acceptable response. 




(2) Tape Resident: 

Possible problems are that the 
input is positioned to the wrong 
file or that the wrong tape is 
mounted. A G response 
causes a new reel to be opened, 
but no repositioning is executed 
by the program if the reel is the 
initial reel of the input file. An 
E response initiates a search 
by the Supervisor for the next 
job. Any other response causes 
an immediate return to the halt. 

6401 

Response field-one 
character. Pass- 
word-eight charac- 
ters. 

Incorrect pass- 
word. 

The valid password may be entered 
into password and a G response 
made. Otherwise, an E is the only 
acceptable response. 

6402 

Response field-one 
character. Pass- 
word-eight char- 
acters. 

Password required. 

The password may be entered into 
password and a G response made. 
Otherwise, an E is the only ac- 
ceptable response. 

6403 

Response field-one 
character. File 
name - ten charac- 
ters. 

Incorrect work-file 
name or work file 
cannot be located. 

If the error is due to an incorrect 
work-file name, the correct name 
may be entered into file -name and 
a G response given. Otherwise, an 
E is the only acceptable response. 

6404 

Response field -one 
character. 

Internal parameter 
record not found. 

A G response will initiate another 
search for the parameter record. 

An E response will cause the Super- 
visor to search for the next job. 
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Table 4-12 (cont). Program Specific Error Conditions 


B -Address 
Register 

A-Address 

List 

Cause 

Action - A=(21 g ), G=(27 g ), E=(25 g ) 

6405 

Response field-one 
character. 

Sequence error. 

The only permitted respone is E, 
thus initiating a search for the next 
job. The sort must be rerun. 

6406 

Response field-one 
character. Error 
code* - one char- 
acter. Discrep- 
ancy^ - three 
characters. 

Item count dis- 
crepancy. 

If an A response is given, the sort 
continues to end-of-job. If an E 
response is given, control is re- 
turned to the Supervisor. The sort 
output file cannot then be processed 
through the Fetch routine or the 
sequential output file program. 

6407 

Response field-one 
character. Work- 
file name - ten 
characters. 

Work file does not 
have a physical 
record size of 250 
characters or is not 
a sequential file. 

The only permitted response is E, 
which initiates a search for the next 
job. The sort must be rerun. 

6410 

Response field-one 
character. 

Restricted sort- 
item block size is 
too small. 

If an A response is given, the sort 
continues using the sort-item block 
size originally computed. An E re- 
sponse initiates a search for the 
next job. 

6411 

Response field -one 
character. Sort- 
item block size- 
four characters 
(decimal). 

A display of sort- 
item block size. 

A G response allows calculation to 
continue. 

6412 

Response field -one 
character. Calcu- 
lation - ten charac- 

■j 

ters . 

A display of results 
of work area calcu- 
lation. 

If only calculations were requested, 
then either a G or an E response 
initiates a search for the next job. 
However, if the intention was to 
execute the sort following calcu- 
lations, the only permitted response 
is E which initiates a search for the 
next job. 

6414 

Response field-one 
character. File 
name - ten charac- 
ters. Device ad- 
dress - three char- 
acters. 

Work files are 
assigned to mixed 
device classes. 

A G response causes the file to 
be reopened. An E response will 
initiate a search for the next job. 

6415 

Response field-one 
character. File 
name - ten charac- 
ters. Device ad- 
dress - three 
characters. 

Volume label not 
found. 

A G response initiates a new search 
for the volume label. An E response 
initiates a search for the next job. 


4-84 


#3-619 






























SECTION IV. MASS STORAGE SORT C 


Table 4-12 (cont). Program Specific Error Conditions 


B -Address 
Register 

A -Address 
List 

Cause 

Action - A=(21 g ), G = (27 g ), E=(25g) 

6450 

Response field-one 
character. File 
name - ten charac- 
ters. 

Incorrect file name 
or output file can- 
not be located. 

If an incorrect file name has been 
given to the sort or to the sequen- 
tial output file program, the cor- 
rect name may be entered in file- 
name and the G response made. 
Otherwise, an E is the only 
acceptable response. 

6451 

Response field-one 
character. Pass- 
word - eight char- 
acters. 

Incorrect password 
for the sequential 
output file. 

The valid password may be entered 
into password and a G response 
made. Otherwise, an E is the only 
acceptable response. 

6452 

Response field -one 
character. 

Insufficient mem- 
ory space for se- 
quential exe- 
cution. 

E is the only acceptable response. 
The sequential output file program 
must be rerun; but it must either be 
assigned more memory or the se- 
quential output file must be reallo- 
cated with a smaller block size. If 
the sequential output file program 
was called through the presence of 
an Output File statement to the sort, 
it is not necessary to rerun the 
sort. Instead, the program should 
be called through an Execute state- 
ment (program- segment -name 
*MSEQFS0), followed by the appro- 
priate set of job control statements. 

6453 

Response field-one 
character. 

Item size less than 
six characters. 

The items of the sequential output 
file do not exceed an item size of 
six characters. E is the only 
acceptable response. 

6454 

Response field -one 
character. 

Parameter records 
not found. 

The only acceptable response is E. 
A possible cause is that an incor- 
rect file name and device address 
have been specified for the work- 
file parameter. 

6455 

Response field-one 
character. 

The sequential out- 
put file has not been 
allocated correctly. 

The only acceptable response is E. 
An example of the type of error that 
causes this halt is the case where 
the item size specified in the file 
description index for the sequential 
output file is not equal to the size 
of the item that is to be placed in 
that file. 
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Table 4-12 (cont). Program Specific Error Conditions 


B -Address 
Register 

A-Address 

List 

Cause 

Action - A=(21g), G=(27g), E=(25g) 

6456 

Response field-one 
character. Error 
code^ - one char- 
acter. Discrep- 
ancy ® - three 
characters. 

Item count discrep- 
ancy. 

This halt occurs if there is an item 
count discrepancy during the creation 
of the sequential output file. If an 
A response is given, the sequential 
output file program continues to end- 
of - j ob . 

6457 

Response field-one 
character. 

Sequential output 
file is too small for 
volume of output. 

An A response will close the output 
file. 

6460 

Response field-one 
character. File- 
name-ten charac- 
ters. 

Work file not 
located. 

This halt occurs if the sequential out- 
put file program is being executed 
and the work file cannot be located. 
The correct name may be entered 
into file -name and a G response 
given. Otherwise an E is the only 
acceptable response. 

6461 

Response field-one 
character. 

Invalid own -code 
address. Conflicts 
with memory re- 
quirements for se- 
quential output file 
program. 

E is the only valid response. The se- 
quential output file program must be 
rerun. Call the program through an 
Execute statement (*MSEQFS0), fol- 
lowed by the corrected set of job 
control statements. 

6462 

Response field -one 
character. 

Illegal parameter 
value specified to 
the sequential out- 
put file program. 

E is the only valid response. The 
sequential output file program must 
be rerun. Call the program through 
an Execute statement (*MSEQFS0), 
followed by the corrected set of job 
control statements. 

6471 

Response field-one 
character. 

Nonexecutable ver- 
sion of Fetch (see 
assembly diag- 
nostics). 

The only valid response is to enter an 
E and return control to the Super- 
visor. 

6472 

Response field-one 
character. 

Sort item has no 
appended address, 
but source pro- 
cessing is requested 
using Fetch routine. 

6473 

Response field -one 
character. 

Buffer sizes too 
small for actual 
block size using 
Fetch routine. 

6474 

Response field-one 
character. 

Sort work file can- 
not be located using 
Fetch routine. 
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Table 4-12 (cont). Program Specific Error Conditions 


B -Address 
Register 

A-Address 

List 

Cause 

Action - A = (21g), G=(27 g ), E=(25g) 

6475 

Response field -one 
character. 

No close parameter 
was specified but 
Fetch has completed 
processing. 

The only valid response is to 
enter an E and return control 
to the Supervisor. 

6476 

Response field-one 
character. 

Parameter record 
not found. 


Error code: 

00 = Presort item count exceeds merge item count. 

01 = Presort item count is less than merge item count. 

2 

Discrepancy - the difference between presort and merge item counts, expressed in binary. 
3 

Format of calculation results - RRRRADDDDA where: 

RRRR - in decimal, the total number of 10-track cylinders required for the 
work area. 

DDDD - in decimal, the number of additional 10-track cylinders needed, 
based upon work area as defined by work-file parameters. 

^Error code: 

00 - Sort item count exceeds sequential output file item count. 

01 - Sort item count is less than the sequential output file item count. 

5 

Discrepancy - The difference between the two item counts, expressed in binary. 


CONSOLE MESSAGES 

When a console message indicates an error or requests operator action, the operator 
performs the following steps. 

1. He reads the typeout. (To repeat the message, he presses the space bar 
twice. ) If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1 -character response (G, E, etc.). 

4. If the typein is correct, he presses the space bar to continue. If incorrect, 
he types any other character and returns to step 3. 


Input/Output Error Conditions 

PERIPHERAL DEVICE CONDITIONS: When the first line of the message typed on the console 
is of the form: 

ppAd message, 

then the condition causing the message is related to peripheral device operation. 

pp = Address assignment of peripheral control (with the leftmost bit set to zero), and 
d = Device number (if applicable). 


4-87 


#3-619 
















SECTION IV. MASS STORAGE SORT C 


If pertinent, and if the device is mass storage, a second line of message is typed. This 

line is a list of information, in the following order. 

Specific code - One character, indicating supplementary information about the 
condition. 

File name - Ten characters, giving the name of the file being processed. 


The operator should determine which peripheral device is referred to by the "pp" and "d" 
portions of the message. If non-mass storage, Table 4-13 should be consulted to determine 
appropriate action. If it is mass storage, refer to the Data Management Subsystem manual. 


The operator must enter a response character (i. e. , type in a character when the TYPE 
light goes on). 


Table 4-13. Peripheral Device Condition Messages 


Typewriter Message 

Cause 

Operator Action 

ppAd READ ERROR 

Uncorrectable read 
error. 

Tape: 

Enter G to reread error record. 
Enter A to bypass error record. 
Enter E to initiate a search by the 
Supervisor for the next job. 

Cards: 

Correct card and reposition card in 
reader. Enter G to reread the 
card. 

If the card cannot be corrected, 
enter an E to initiate a search by the 
Supervisor for the next job. 

ppAd WRITE ERROR 

Uncorrectable write 
error. 

Enter G to rewrite the record. 
Enter E to initiate a search by the 
Supervisor for the next job. 

ppAd END VOLUME 

Halt for multireel 
input or output. 

Mount the next reel on the drive in 
use for the file. The only valid 
response is G; this causes the 
program to continue. 


INPUT/OUTPUT FILE CONDITIONS: When the first line of message typed out is of the form: 
pp d FILE filename, message 

then the condition causing the message is related to logical operations with the files. 

pp = Address assignment of peripheral control (with the leftmost bit 
set to zero); 

d = Device number; and 
filename = Name of the file being processed. 


4-88 


#3-619 














SECTION IV. MASS STORAGE SORT C 


A second line of message is also typed. This line includes the following. 

Specific code - One character, giving supplementary information about the 
condition. 

File name - Ten characters, giving the name of the file being processed. 


The operator should determine which peripheral device is referred to by the "pp" and "d" 
portions of the message. If non-mass storage, then Table 4-14 should be consulted to determine 
appropriate action. If it is mass storage, refer to the Data Management Subsystem manual. 


The operator must enter a response character. 


Table 4-14. Input/Output File Condition Messages 


Typewriter Message 

Cause 

Action 

ppAdAFILE filename, 
FILE NOT FOUND 
Supplementary Information: 
Specific Code - one 
character (3). 
ppd - two characters. 
File name - ten char- 
acters. 

1HDRA not found for input file. 
(Possibly, the input tape is 
mispositioned or the wrong 
tape is mounted. ) 

Enter G to reopen a new 
reel. No repositioning is 
executed if the reel is the 
initial reel of the input file. 
Enter E to initiate a search 
by the Supervisor for the 
next job. 

ppAdAFILE filename, 
RETENTION CYCLE NOT 
EXPIRED 

Supplementary Information: 
Specific Code - one char- 
acter (Z). 

ppd - two characters. 

File name - ten charac- 
ters. 

yyddd - creation date 

(five characters). 

Retention cycle has not ex- 
pired. 

Enter A to accept the 
mounted reel. 

Enter G to open a newly 
mounted reel. If the reel 
is accepted, processing 
continues. 

Enter E to initiate a 
search by the Supervisor 
for the next job. 

ppAdAFILE filename, 
RECORD COUNT INCOR- 
RECT 

Supplementary Information: 

Specific Code - one char- 
acter (@). 

ppd - two characters. 

File name - ten charac- 
ters. Input reel record 
count -five characters. 

Input reel record count in- 
correct. 

Enter A to continue pro- 
cessing. 

Enter E to initiate a 
search for the next pro- 
gram. 
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Table 4-14 (cont). Input/Output File Condition Messages 


Typewriter Message 

Cause 

Action 

ppAdAFILE filename, 

Reel sequence incorrect. 

Enter A to accept the 

VOLUME SEQUENCE 


reel and continue pro- 

NUMBER ERROR 


cessing. Enter E to 

Supplementary information: 


initiate a search by the 

Specific code - one char- 


Supervisor for the next job. 

acter (=). 


Enter G to reopen a new 

ppd - two characters. 


reel. No repositioning is 

File name - ten charac- 


executed by the program if 

ters. Input reel se- 


the reel is the initial reel 

quence number - three 


of the input file. 

characters. 





Job Control File Conditions 

When the line typed out is of the form: 

JOB CONTROL FILE ERROR, message 

then the condition demanding a response is related to the job control file. No second line is typed. 


When applicable, the above type out is followed by: 

CANNOT REFEED, A 
Messages are listed in Table 4-15. 


Table 4-15. Job Control File Condition Messages 


Typewriter Message 

Cause 

Action 

JOB CONTROL FILE ERROR, 
SYNTAX 

Syntactic (grammatical) 
error; e.g., a right 
parenthesis is missing. 

If the error can be cor- 
rected, refeed the set of 
job control statements 
(excluding the Execute 
statement) and enter G. 

If the error cannot be cor- 
rected, enter E to 
initiate a search by the 
Supervisor for the next 
job. 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Statement not recognized. 

JOB CONTROL FILE ERROR, 
POSITIONAL PARAMETER 

Invalid positional pa- 
rameter. 

JOB CONTROL FILE ERROR, 
KEYWORD PARAMETER 

Invalid keyword. 

JOB CONTROL FILE ERROR, 
MISSING PARAMETER 

Required parameter 
missing. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Invalid parameter 
value. 

JOB CONTROL FILE ERROR, 
PARAMETER COMBINATION 

Invalid combination of 
parameters. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Illegal parameter value. 
No further specification 
given. 

If the error can be cor- 
rected, refeed the set of 
job control statements 
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Table 4-15 (cont). Job Control File Condition Messages 


Typewriter Message 

Cause 

Action 

JOB CONTROL FILE ERROR, 
OWN-CODE ADDRESS 

Invalid own -code ad- 
dress. Conflicts with 
sort memory require- 
ments. 

preceded by the Execute 
statement (program-seg- 
ment-name &SORT3PO) and 
enter E. If correction is 
not possible, enter E to 
initiate a search by the 
Supervisor for the next job. 

JOB CONTROL FILE ERROR, 
INSUFFICIENT MEMORY 

Insufficient memory 
space to execute the 
sort. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Illegal parameter value 
for key and extract 
fields . 

JOB CONTROL FILE ERROR, 
KEY OR EXTRACT FIELD 

Key and extract fields 
overlap or are incon- 
sistent with the item 
size. 

JOB CONTROL FILE ERROR, 
SELECT OR DELETE FIELD 

Error in the select 
and delete parameter 
values. 

JOB CONTROL FILE ERROR, 
INSUFFICIENT WORK FILE 

Insufficient work file 
area. 


Conditions Specific to the Sort, Fetch Macro Routine, and Sequential Output File Program 

Table 4-16 lists the messages for conditions specific to the sort, the Fetch macro routine, 
and the sequential output file program. 


Table 4-16. Messages for Conditions Specific to the Sort, Fetch Macro Routine, 
and Sequential Output File Program 


Typewriter Message 

Cause 

Action 

INPUT FILE NOT FOUND 

Supplementary information: 
File -name - ten characters. 

Incorrect file name or input 
file not located. 

Mass Storage Resident: 

A G response will re- 
initiate the search for the 
file. An E response returns 
control to the Supervisor. 

Tape Resident: 

Enter G to open a new reel. 
No repositioning is executed 
by the program if the reel 
is the initial reel of the input 
file. Enter E to initiate a 
search by the Supervisor for 
the next job. 
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Table 4-16 (cont). Messages for Conditions Specific to the Sort, Fetch Macro Routine, 

and Sequential Output File Program 


Typewriter Message 

Cause 

Action 

PASSWORD ERROR 

Supplementary information: 

Password - eight characters. 

Incorrect password. 

A G response will reinitiate 
the search for the file. An 
E response returns control 
to the Supervisor. 

PASSWORD ERROR 
Supplementary information: 

Password - eight characters. 

Password required. 

WORK FILE NOT FOUND 

Supplementary information: 
File -name - ten characters. 

Incorrect work-file name or 
work file cannot be located. 

PARAMETER RECORD NOT 
FOUND 

Internal parameter record 
not found. 

Enter G to initiate another 
search for the parameter 
record. Enter E to cause 
the Supervisor to search for 
the next ,iob. 

SEQUENCE ERROR 

Sequence error. 

The only permitted response 
is E. The sort must be 
rerun. 

ITEM COUNT DISCREPANCY 

Supplementary information: 

Error code^ - one character. 

Discrepancy^ - three char- 
acters. 

Item count discrepancy. 

Enter A for sort to con- 
tinue to end -of -job. Enter 
E to return control to 
Supervisor. The sort output 
file cannot then be processed 
through the Fetch routine 
or the sequential output file 
program. 

WORK FILE ALLOCATION 

Supplementary information: 
Work -file -name - ten 
characters. 

Work file does not have a 
physical record size of 250 
characters or is not a se- 
quential file. 

The only permitted response 
is E. The sort must be 
rerun. 

SORT -ITEM BLOCK 
RESTRICTION 

Restricted sort-item block 
size is too small. 

Enter A for the sort to con- 
tinue using the sort-item 
block size originally com- 
puted. Enter E to initiate 
a search for the next job. 

SORT -ITEM BLOCK SIZE 

Supplementary information: 
Sort-item block size - four 
characters (decimal). 

A display of sort -item block 
size. 

Enter G to allow calculation 
to continue. 

CALCULATION RESULTS 

Supplementary information: 
Calculation^ - ten char- 
acters. 

A display of results of work 
area calculation. 

If calculations only were 
requested, enter G or E to 
initiate a search for the next 
job. If the intention was to 
execute the sort following 
calculations, the only accep- 
table response is E. 
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Table 4-16 (cont). Messages for Conditions Specific to the Sort, Fetch Macro Routine, 

and Sequential Output File Program 


Typewriter Message 

Cause 

Action 

WORK DEVICES INCOMPATIBLE 

Work files are assigned 

A G response causes the 

Supplementary information: 
File name - ten characters. 
Device address - three 

to mixed device classes. 

file to be reopened. An E 
response returns control 
to the Supervisor. 

characters . 



VOL LABEL NOT FOUND 

Volume label not found. 

A G response initiates a 

Supplementary information: 
File name - ten characters. 
Device address - three 
characters. 


new search for the volume 
label. An E response 
initiates a search for the 
next job. 

OUTPUT FILE NOT FOUND 

Incorrect file name or 

A G response will reinitiate 

Supplementary information: 
File name - ten characters. 

output file cannot be 
located. 

the search for the file. An 
E response returns control 
to the Supervisor. 

PASSWORD ERROR, OUTPUT 

Incorrect password for 


FILE 

the sequential output 


Supplementary information: 

file. 


Pas sword -eight characters. 



INSUFFICIENT MEMORY, 

Insufficient memory 

E is the only acceptable 

SEQUENTIAL OUTPUT PRO- 

space for sequential exe- 

response. The sequential 

GRAM 

cution. 

output file program must be 
rerun; but it must be as- 
signed more memory or the 
sequential output file must 
be reallocated with a 
smaller block size. If the 
sequential output file pro- 
gram was called through the 
presence of an Output File 
statement to the sort, it is 
not necessary to rerun the 
sort. Instead, the program 
should be called through an 
Execute statement (program- 
segment -name *MSEQFS0), 
followed by the appropriate 
set of job control statements. 

ITEM SIZE LESS THAN 6 

Item size less than 
six characters. 

Only E is acceptable. 

PARAMETER RECORD NOT 

Parameter records 


FOUND 

not found. 


OUTPUT FILE ALLOCATION 

The sequential output 
file has not been al- 
located correctly. 
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Table 4-16 (cont). Messages for Conditions Specific to the Sort, Fetch Macro Routine, 

and Sequential Output File Program 


Typewriter Message 

Cause 

Action 

ITEM COUNT DISCREPANCY 

Supplementary information: 

Error code^ - one character. 

Discrepancy^ - three charac- 
ters. 

Item count discrepancy. 

Enter A for sequential output 
file program to continue to 
end -of -job. 

OUTPUT FILE TOO SMALL 

Sequential output file is 
too small for volume of 
output. 

Enter A to close the output 
file. 

WORK FILE NOT FOUND 

Supplementary information: 
File name - ten characters. 

Work file not located. 

A G response will reinitiate 
the search for the file. An 
E response returns control 
to the Supervisor. 

OWN-CODE ADDRESS - SE- 
QUENTIAL OUTPUT PRO- 
GRAM 

Invalid own-code address. 
Conflicts with memory 
requirements for se- 
quential output file pro- 
gram. 

Only E is valid. The se- 
quential output file program 
must be rerun. Call the 
program through an Execute 
statement (program-seg- 
ment-name *MSEQFS0), fol- 
lowed by the corrected set 
of job control statements. 

PARAMETER VALUE, SE- 
QUENTIAL OUTPUT PRO- 
GRAM 

Illegal parameter value 
specified to the sequen- 
tial output file program. 

Only E is valid. The se- 
quential output file program 
must be rerun. Call the 
program through an Execute 
statement (program-seg- 
ment-name *MSEQFS0), fol- 
lowed by the corrected set 
of job control statements. 

FETCH CANNOT BE EXE- 
CUTED 

Nonexecutable version of 
F etch. 

Enter E. 

FETCH CANNOT ACCESS 
SOURCE FILE 

Sort item has no appended 
address, but source pro- 
cessing is requested using 
Fetch routine. 

BUFFER SIZE INCORRECT - 
FETCH 

Buffer sizes too small for 
actual block size using 
Fetch routine. 

WORK FILE NOT FOUND 

Sort work file cannot be 
found using Fetch routine. 

FETCH CANNOT CLOSE 

No close parameter was 
specified, but Fetch has 
completed processing. 
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SECTION IV. MASS STORAGE SORT C 


Table 4-16 (cont). Messages for Conditions Specific to the Sort, Fetch Macro Routine, 

and Sequential Output File Program 


Typewriter Message 

Cause 

Action 

PARAMETER RECORD NOT 
FOUND 

Parameter record not 
found. 

Enter E. 


Error code: 

00 = Presort item count exceeds merge item count. 

01 = Presort item count is less than merge item count. 

2 

Discrepancy - the difference between presort and merge item counts, expressed in binary. 

3 

Format of calculation results - RRRRADDDDA where: 

RRRR - in decimal, the total number of 10-track cylinders required for the work area. 
DDDD - in decimal, the number of additional 10-track cylinders needed, based upon 
work area as defined by work-file parameters. 

4 

Error code: 

00 - Sort -item count exceeds sequential output file item count. 

01 - Sort-item count is less than the sequential output file item count. 

5 

Discrepancy - The difference between the two item counts, expressed in binary. 
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MASS STORAGE EDIT C 


Mass Storage Edit C (hereinafter referred to as the edit program) is a utility routine in 
the Series 200/Operating System - Mod 1 (Mass Storage Resident). 

The edit program cannot be run in a multiprogramming environment. 

EQUIPMENT REQUIREMENTS FOR MASS STORAGE EDIT C 

Basic Equipment Requirements 

The following equipment is required for the edit program: 

A Series 200 central processor; 

Advanced Programming Instructions; 

A minimum of 12, 288 characters of main memory; and 
One disk device and associated control. 

This combination may be any one of the following. 


I 


Also required are one card reader and one printer. 

Additional Usable Equipment 

The following additional equipment also may be used: 

One Type 220-1, -3 Console (console I/O requires 4, 096 additional characters 
of main memory); 

FUNCTIONAL DESCRIPTION OF MASS STORAGE EDIT C 

The edit program provides a printed representation of the physical data stored on any mass 
storage device. Parameters to the edit program specify the device address and the areas to be 
edited. The parameters are entered through the job control file, and the areas to be edited are 


Device Type 

Control Type 

155 

157C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

259A 

257A 

259B 

257B 

261 

260 

262 

260 
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bounded below and above by the cylinder and track values of the starting and terminating ad- 
dress parameters. An alphabetic or an octal listing can be specified. 

The edit program does not respect the conventions of the Data Management Subsystem. 
Therefore, a user wishing to edit a specific file should use File Support C (refer to the Data 
Management Subsystem manual). 

Features of Mass Storage Edit C 
HEADER LINE 

The header line of the edit program contains the following information printed at the top 
of each page: 

1. Peripheral address assignment of the control (pos. 3-12), 

2. Device number (pos. 16-25), 

3. Pack address (pos. 29-38), 

4. Title "MSAEDIT" (pos. 52-60), and 

5. Page number (pos. 99-110). 

HEADER LINE RECORD 

This line contains the following decimal information: 

1. Cylinder number (pos. 14-21), 

2. Track number (pos. 25-34), 

3. Flag character of the record header (showing protection status), as 
recorded on disk (pos. 38-43), 

4. Record number (pos. 47-60), and 

5. Data length (pos. 64-79). 

DATA PORTION LINE 

This line contains the following information: 

1. Read error information (pos. 1-3); appears on first line of record only; 

2. Character positions (pos. 7-10); indicates position in record of first 
character in this line; and 

3. Data characters of record (pos. 14-113); this line type is repeated as 
necessary to exhaust the record. 

END-OF-JOB LINE 

This line contains the following information: 

1. END EDIT (pos. 14-26), 

2. Number of tracks processed (pos. 30-50), 
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3. Number of records processed {pos. 54-75), and 

4. Number of errors (pos. 79-99). 

JOB CONTROL LANGUAGE FOR MASS STORAGE EDIT C 
Requesting an Edit Operation 

The edit program can print as many as six areas from one mass storage device in one 
operation. In order to edit from more than one device, the edit program must be requested again. 


The specification of the parameters to the edit program, i.e. , mass storage areas, for- 
mat of the listing, etc., is made through statements in the job control file (see Figure 5-1). 
The job control file must be in a card reader. 


EASYCODER 

COOING FORM 

PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

f 

u 

> 

LOCATION 

OPERATION 

CODE 

OPERANDS 


1 2 3 4 1 5 

6 

8 , .14 

5, 20 

2I . ... i .... i .... i .... ........... . K 

63 . , . .80 

■ KJ- 



5X . . . 

* MS ED, I T.A > 


■ r 



VOLUME 

Pg,0M«i(A> .O. v T.o,»Lc,, . 


.i.i 


. . 1 . . . 

i . . . . 

DE.VADD*.( pc.u. driv.c.Yj , . . 

Opfionol, . , 

i I 




......... (ALPHA) / 


i ■ i 
i.i 



PILE 

M.SX.,F0ftM».{ .... .L ... 1 

Ojtfipnal, , 

i i 




.... i .... i PC TAU. . .... i .... i .... i . 

.... 






. . i . . . ■ , . 1 

1 ! 1 1 



l . . . . 

OE.V ADD *. ( pc,u\ v . , . , 

Optional 

t i 








l . ■ . 

1 . .... > 

... A 1 .... 1 .... 1 .... 1 . * A . i.. . 1 . . . . 1 A . A . 1 . | 

. . i ... . 


Figure 5-1. Job Control Statements for Mass Storage Edit C 


Two job control statements are required: an Execute statement to load the edit program, 

and a Volume statement to give the parameters. If the edit is to be in octal form or if the con- 
trol unit address of the printer is not 02, then the File statement is also required. 

EXECUTE STATEMENT 

The format of the Execute statement is shown in Figure 5-1. 

VOLUME STATEMENT 

The Volume statement (see Figure 5-1) gives the parameters of the edit operation. One 
Volume statement describes a maximum of six areas to be edited, as long as they are all on 
the same mass storage device. The parameters are described in the following paragraphs. 
Optional parameters have an assumed or "default" value. When such a parameter is omitted 
from the job control statements, the default value is used. 


5-3 


#3-619 




SECTION V. MASS STORAGE EDIT C 


The Volume and File statements may appear on one or more lines (for a card deck, one 
"line" is one card). The last line must have an E in the mark field. The line containing the E 
may be the same line as the last line containing a parameter or may be a following line con- 
taining no parameters. 

FROM and TO Parameters 

One pair of FROM and TO parameters describes one mass storage area to be edited; there 
must be at least one such pair. However, one Volume statement may contain as many as six 
pairs describing the areas to be edited. 

The "c" value of the parameter is the cylinder address in decimal; the first cylinder on a 
device is numbered zero. The "t" value of the parameter is the track address in decimal; the 
first track on a cylinder is numbered zero. The FROM and TO parameters take the form: 

I FROM = (c,t), TO = (c, t), .. . 


For a given pair of FROM and TO parameters, the area to be edited includes all the tracks 
and cylinders stated in the parameter (inclusive). All records on each track are edited, in- 
cluding the track-linking record. 

The device type, as defined in column 12 of the volume label of the volume being edited, 
determines the maximum cylinder and track values allowable. The permissible values are 
shown in Table 5-1. If the values specified in the FROM and TO parameters exceed these values, 
an illegal parameter halt or a console message occurs. 


Table 5-1. Permissible Cylinder -Track Values for Edit 



Volume Label 
Column 12 Symbol 



Device Type 

Octal 

Alpha 

Range of Cylinder Values 

Range of Track Values 

155 

21 

A 

0 - 202 

0 - 1 

258 

11 

9 

0 - 103 

0-9 

259, 259A, 259B 

12 

I 

0 - 202 

0 - 9 

273 

13 

= 

0 - 202 

0-19 

261 

31 

I 

0 - 127 

0 - 127 

262 

32 

9 

0 - 127 

0 - 127 

26 1L 

33 

• 

0 - 127 

0 - 127 

262L 

34 

) 

0 - 127 

0 - 127 


NOTE: Some cylinders which may be edited are reserved for systems use 
and are not allocatable. 
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Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical address of the mass 
storage device being edited. The peripheral address assignment of the control unit (pcu) is 
written as two octal digits. The I/O bit is not required, but all other bits must be specified, in- 
cluding the sector bits. The drive number of the mass storage device is written as one octal 
digit. When the device address parameter is omitted, the assumption is that the pcu is 04 and 
the drive number is zero. The device -address parameter takes the following form. 

FILE STATEMENT 

The File statement (see Figure 5-1) has the I/O function name "LIST" as the first pa- 
rameter of the statement. This statement is not required, unless octal printing or a non- 
standard print device number is desired. 

Form Parameter 

The form parameter (FORM) specifies the format of the edit listing. When written as 
"FORM=OCTAL, " an octal listing is produced. When written as "FORM=ALPHA, " an alphabetic 
listing is produced. When the form parameter is omitted, the listing is alphabetic. The form 
parameter has the following format. 



Device-Address Parameter 

The device-address parameter (DEVADD) specifies the physical address of the printer. 
The peripheral address assignment of the control unit (pcu) is written as two octal characters. 
When this parameter is omitted, the pcu value 02 is assumed. The form of the device address 
parameter is as shown below. 

I DEVADD = (pcu), 


Examples of Use of Mass Storage Edit C 

In the following example, the printer is on pcu 03 and the listing desired is ALPHA. A 
File statement is necessary. Two areas will be listed. The edit program is resident on a disk 
device (0), while the volume being edited is on pcu 04, drive 1. The first area listed consists of 
12 tracks; i. e. , tracks 02 through 05 on cylinders 37 through 39. The second area listed con- 
sists of six tracks; i. e. , tracks 01 through 06 on cylindei 00. 
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EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE PAGE OF 



I 

LOCATION 

OPERATION 

COOE 

OPERANDS 


no 

DOE) 

□E 

IOHIHC 





m 


mm 

71— 

—————— 



HI 


HH 


6E.VAW)*.(iS4, T .l V, . . . . 


M 

— 


Ml 


FROM r , (.3.7. . .2. V , TO * ,( .5.9. , .5,\ , . 


■ 

m 


HU 


FROM* 1 ((Z>.-l')'.TO*( 1 <?.6 s )., 


MH 


hm 

F.tLE 

list.., . . ", r 


nr 




MW— I— UMiBglgHBiBi 


MU 


1— M 

— 




In the following example, the printer is on pcu 02 and the listing desired is ALPHA, No 
File statement is necessary. The edit program is resident on a tape (drive 0). The volume being 
edited is on the default device address (04,0).. A total of 14 tracks will be listed (tracks 03 
through 09 on cylinders 01 and 02). 


EASYCODER 

COOING FORM 


PROBLEM PROGRAMMER DATE PAGE OF 


CARD 

NUMBER 

l 

* 

8 

LOCATION 

OPERATION 

CODE 

OPERANDS 


1 2 I 3 4l5 

6 

7 

e . i4 

15, 20 


63 , , | , , . .80 


n 

i! 


iHUM 


MM— MMMHMMM 


i 

B 




— M HIM MH 

‘ i 1 i 
1 

i 

1 






_ 


■ ■ t-^ • ■ 

» • • — i — i— 

. . 1 ■ ■ . . 1 ■ . 1 i_» . . 1 i 1 1 ■ 1 ■ 1 1 l__J l_t L_J < ■ ■ • 1 1 1_ 



In the following example, *MSEDIT is executed from a resident file on device 0 (boot 64). 
The volume being edited is on device 2 (second sector) and must be a Type 261 or 262 Disk File. 
A total of 24 tracks are edited in octal form (tracks 14 through 19 on cylinders 88 through 91). 


EASYCODER 

COOING FORM 


PROBLEM .PROGRAMMER DATE FAGE__0F_ 


CARO 

NUMBER 


y 

8 

LOCATION 

OPERATION 

CODE 

OPERANDS 


1 2 | 3 4 1 5 

6 

7 

B , 14 

15, .20 

2 ’. ... 1 .... 1 ■ . . 1 . , , , 1 , . , 1 . . . . 1 .« 

«. ■ i . . . ■ i . . . - 80 




i . . . 

BM— 1 

*M&.EE.»TA . , x ... 


, ! 1 






MM MH Ml— 1 

- . i . 



. . 1 . 


ffliniHHH— if— i— IMHMii 

H— | m— ■ 

i 

1 

a 


F,LL.E 


M— M— H 

mm 

- 

- 



MMHHMH— H—HHi 

— — MM— 


OPERATING PROCEDURES FOR MASS STORAGE EDIT C 
Loading Mass Storage Edit C 

The program-segment name for the edit program is "*MSEDITA. " 
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LOADING FROM MASS STORAGE 

The Execute statement must precede the job control statements for the edit run. 

LOADING FROM MAGNETIC TAPE 

A console call card (see second example) must precede the job control statements for the 
edit run when executed under control of Floating Tape Loader -Monitor C. 

OPERATOR CONTROL 

Error conditions are indicated either by a halt defined through the contents of the B-address 
register or by a console message. 

Control Panel Halts 

When a control panel halt occurs and when the appropriate corrective action has been taken, 
the operator responds by entering a character in the location specified by the A-address register. 

Table 5-2 lists halt codes and operator responses for the edit program. 


Table 5-2. Halt Codes and Operator Responses for Mass Storage Edit C 


B -Address 
Register 

Cause 

Action^ 

ppOd 

The device is inoperable. 

Cycle up the device and enter a 
G response. 

ppld 

Card read error. 

Correct the card, reposition it in 
the card reader, and enter a G to 
continue. 

If the card cannot be corrected, 
enter an E to exit to the Supervisor. 

pp2d 

Write error on printer. 

Enter a G response to attempt to 
print again. Enter an E response 
to terminate job. 

PP7d 

A device malfunction such 
that edit processing can- 
not continue. 

The only acceptable response is 
E, which initiates a search by 
the Supervisor for the next job. 

5000 

Syntactic (grammatical) 
error in a job control 
statement. 

Correct the statement causing the 
error and refeed the control 
statements. Enter a G into the 
response location. (The Execute 
statement must not be included. ) 

5001 

Invalid statement. 

Entering an E into the response 
location initiates a search by the 
Supervisor for the next job. 

5003 

Invalid keyword. 

5040 

Illegal parameter value. 

Cards cannot be refed. Enter a 
G into the response location to 
continue processing parameters. 

Entering an E into the response 
location initiates a search by the 
Supervisor for the next job. 
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Table 5-2 (cont). Halt Codes and Operator Responses for Mass Storage Edit C 


B -Address 
Register 

Cause 

Action^- 

6600 

More than six pairs of 
FROM and TO parameters 
specified. 

The halt occurs for each pair exceeding 
six. Entering a G response causes the 
halt to be repeated until no more pairs 
are encountered. The edit then pro- 
cesses the first six pairs specified in 
the Volume statement. Entering an E 
returns control to the Supervisor. 

*G = (27g), E = (25g). 


Console Messages 

When a console message indicates an error or requests operator action, the operator per- 
forms the following steps. 

1. He reads the typeout. (To repeat the message, he presses the space bar 
twice.) If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1-character response (G, E, etc.). 

4. If the typein is correct, he presses the space bar to continue. If incorrect, 
he types any other character and returns to step 3. 


Table 5-3 lists console messages and operator responses for the edit program. 
Table 5-3. Console Messages for Mass Storage Edit C 


Message 

Cause 

Action 

pp d INOPERABLE 

The device is inoperable. 

Cycle up the device and enter 
a G response. 

pp d READ ERROR 

Card read error. 

Correct the card, reposition it 
in the card reader, and enter 
a G to continue. 

If the card cannot be corrected, 
enter an E to exit to the Super- 
visor. 

pp d WRITE ERROR 

Error in printing. 

Enter a G response to attempt 
to print again. Enter an E re- 
sponse to terminate job. 

pp d MISCELLANEOUS 

A device malfunction such 
that edit processing can- 
not continue. 

The only acceptable response 
is E, which initiates a search 
by the Supervisor for next job. 

JOB CONTROL FILE ERROR, 
SYNTAX 

Syntactic (grammatical) 
error in a job control 
statement. 

Correct the statement causing 
the error and refeed the job 
control statements. Enter a 
G. (The Execute statement 
must not be included. ) 


7/15/70 


5-8 


#3-619 





























SECTION V. MASS STORAGE EDIT C 


Table 5-3 (cont). Console Messages for Mass Storage Edit C 


Message 

Cause 

Action 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Invalid statement. 

Entering an E initiates a search 
by the Supervisor for the next 
job. 

JOB CONTROL FILE ERROR, 
KEYWORD 

Invalid keyword. 

Entering an E initiates a search 
by the Supervisor for the next job. 

JOB CONTROL FILE ERROR, 
ILLEGAL PARAMETER 

Illegal parameter value. 

Cards cannot be refed. Enter 
a G to continue processing 
parameters. Entering an E 
initiates a search by the 
Supervisor for the next job. 

TOO MANY AREAS SPECI- 
FIED 

More than six pairs of 
FROM and TO param- 
eters specified. 

The message occurs twice for 
each pair exceeding six. Enter- 
ing a G response causes the 
message to be repeated until no 
more pairs are encountered. 

The edit then processes the 
first six pairs specified in the 
Volume statement. Entering 
an E returns control to the 
Supervisor. 
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SECTION VI 
DISK/TAPE COPY C 


Disk/Tape Copy C is a utility routine of the Mod 1 (MSR) Operating System. It offers a 
fast method of achieving backup security and reproducing previously generated system volumes. 

Disk/Tape Copy C is intended as a faster but physically constrained supplement to the 
more flexible methods of File Support C. For those situations where logical reorganization of 
data is desired, the user should consult the File Support C section of the Mod 1 (MSR) Data 
Management Subsystem manual. 

Disk/Tape Copy C copies rectangular areas * or named files from a mass storage volume 
onto either magnetic tape or another mass storage volume. The copy on magnetic tape can be 
copied back, in whole or in part, to any mass storage volume mounted on a device of the same 
class as the original input device. 

When the copy-by-rectangle method is used, as many as 16 rectangles can be copied. 

When the copy-named-files method is used, any number of named files can be copied. 

To be acceptable for copying, a mass storage volume must have been created according to 
data management conventions. It must have a track format that identifies the first record on 
each track as record zero; all subsequent records are consecutively numbered in binary. 

Use of Disk/Tape Copy C assumes familiarity with the conventions of the Data Management 
Subsystem. 

EQUIPMENT REQUIREMENTS FOR DISK/ TAPE COPY C 

Basic Equipment Requirements 

The following basic equipment is required: 

A Series 200 central processor; 

Advanced Programming Instructions; 

12, 288 characters of main memory (Type 261 and 262 Disk Files require 
8, 192 additional characters of main memory); and 

One disk device and associated control. 

*A rectangular area is specified by a pair of FROM and TO parameters as described later in 
this section under "Job Control Language for Disk/Tape Copy C. " 


6-1 


#3-619 


SECTION VI. DISK/TAPE COPY C 


This combination may be any one of the following. 


I 


When either an input or an output mass storage volume is mounted on a 
Type 259A or 259B Disk Pack Drive, the user should insert the value 259 
in the appropriate device-type parameter. This requirement is noted in 
this section under "Job Control Language for Disk/Tape Copy C. " 

Also required are one card reader and one Type 222 Printer. 

In addition, at least one of the following is required: 

One more disk device, as described above, or one Type 204B Magnetic 
Tape Unit and one tape control unit. 

Additional Usable Equipment 

The following additional equipment may be used. 

* One Type 220-1, -3 Console (console I/O required 4, 096 additional 

characters of main memory); 

Second I/O Sector (Feature 1115 for Model 2200); 

Additional disk device(s) and control(s); and 
Additional Type 204B Magnetic Tape Units. 

FUNCTIONAL DESCRIPTION OF DISK/TAPE COPY C 

Disk/Tape Copy C offers three copy options — - disk-to-tape copy, tape-to-disk copy, and 
disk-to-disk copy — and two copy methods — copy-by-rectangle and copy-named-files. Either 
copy method can be used with any of the copy options, but only one copy options and one copy 
method can be used during one execution of the routine (e.g. , a disk-to-tape copy run using the 
copy-by- rectangle method or a tape-to-disk copy run using the copy-named-files method). 


Device Type 

Control Type 

155 

157C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

259A 1 

257A 

259B 1 

257B 

261 

260 

262 

260 


Copy Options of Disk/Tape Copy C 

The three copy options of Disk/Tape Copy C are illustrated in the following paragraphs. 

A detailed description of all job control language appears under "Job Control Language for Disk/ 
Tape Copy C, " later in this section. 
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OPTION 1 - DISK INPUT, TAPE OUTPUT (DISK-TO-TAPE COPY) 

The disk-to-tape copy option must include either the copy-by-rectangle method or the 
copy-named-files method (but not both during one execution of the routine). The copy-by- 
rectangle method is specified by including from one to 16 pairs of FROM and TO parameters 
in the Input Volume statement. The copy-named-files method is specified by including one File 
statement for every file to be copied. (Any number of File statements can be included: they must 
appear between the Input Volume and Output Volume statements. ) 

If the copy-by- rectangle method is specified, an entire mass storage volume (one rectangle 
or as many as 16 selected areas (16 rectangles)) can be copied to an output magnetic tape. If 
the copy- named-files method is selected, any number of named files can be copied from a mass 
storage volume to an output magnetic tape. 

A mass storage volume of a Type 259 Disk Pack Drive requires about 1400 feet of output 
tape (using a density of 556 BPI); a volume of a Type 261 Disk File requires a 2400-foot reel of 
output tape for each 13 cylinders copied. 

A set of job control statements for a disk-to-tape copy run is shown in Figure 6-1. This 
figure illustrates the copy-by-rectangle method since a pair of FROM and TO parameters is 
included. If the copy-named-files method is desired, the pair of FROM and TO parameters is 
not used; instead, a File statement is used for each file to be copied from disk to tape. 
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Figure 6-1. Job Control Statements for Disk-to-Tape Copy Option 
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OPTION 2 - TAPE INPUT, DISK OUTPUT (TAPE-TO-DISK COPY) 

The tape-to-disk copy option requires that the input tape be the product of a previous disk- 
to-tape copy run. The tape-to-disk copy run recopies mass storage rectangles or named files 
to: (1) the original mass storage volume or (2) any other mass storage volume mounted on a 

device of the same class as the original input device. Each track in a rectangle or named file 
is copied to the same cylinder and track address that it occupied on the original input mass 
storage volume. 


A set of job control statements for a tape-to-disk copy run is shown in Figure 6-2. This 
figure illustrates the copy-named-files method since a File statement is included. (Use of the 
copy-named-files method requires that the input tape for this run be the product of a previous 
disk-to-tape copy run that also used the copy-named-files method. Of course, the input tape 
must contain the file named in the File statement. ) 


If the copy-by-rectangle method is desired, the File statement is not used; instead, one or 
more pairs of FROM and TO parameters (one pair for each area to be copied) is used in the Input 
Volume statement. * 
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Figure 6-2. Job Control Statements for Tape-to-Disk Copy Option 


OPTION 3 - DISK INPUT, DISK OUTPUT (DISK-TO-DISK COPY) 

The disk-to-disk copy option can be used for system generation since it can create an 
operational output volume that duplicates system files on an input volume. The same result can 


The tape-to-disk copy option does not require that the copy-by-rectangle or copy-named-files 
method be specified. If neither is specified, the implication is that the same method used to 
create the input tape will be used during the current tape-to-disk copy run; however, all 
rectangles or all files originally copied to the tape will now be copied to the designated output 
mass storage volume. 
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be achieved, when desired, in a 2-step process by using option 1 (disk-to-tape copy) followed 
by option 2 (tape-to-disk copy). 

For Type 155 Disk Pack Drives the only permissible disk-to-disk copy is from one Type 
155 to another. If a user wishes to transfer data between any other disk pack drive or disk file 
and a Type 155 Disk Pack Drive, the 2-step process using option 1 followed by option 2 must 
be used. 

The disk-to-disk copy option must include either the copy-by-rectangle or the copy-named- 
files method. The FROM and TO parameter(s) or File statement(s) are specified as shown above 
under "Option 1 — Disk Input, Tape Output (Disk-to-Tape Copy). " Each track in a rectangle or 
named file is copied to the same cylinder and track address that it occupied on the input mass 
storage volume. 

A set of job control statements for a disk-to-disk copy run is shown in Figure 6-3. This 
figure illustrates the copy-named-files method since a File statement is included. 
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Figure 6-3. Job Control Statements for Disk-to-Disk Copy Option 


Copy Methods of Disk/Tape Copy C 

Either the copy-by-rectangle method or the copy-named-files method can be used with any 
of the three copy options, as described below. Only one copy method and one copy option can be 
used during one execution of Disk/Tape Copy C. 

COPY-BY-RECTANGLE METHOD 

The copy-by-rectangle method permits the user to specify up to 16 rectangular areas that 
are to be copied by one of the three copy options. The user defines each rectangular area to be 
copied by including a pair of FROM and TO parameters in the Input Volume statement of the job 
control file. 

During a tape-to-disk copy run, each rectangle specified to be copied must be equal to or 
smaller than (i. e. , within) a rectangle or unit of allocation that has previously been copied to the 
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input tape. Only one pair of FROM and TO parameters can be specified for each unit of alloca- 
tion that is to be copied from the input tape. 

COPY-NAMED-FILES METHOD 

The copy-named-files method permits the user to specify any number of named files that 
are to be copied by one of the three copy options. The user specifies each file to be copied by 
including a separate File statement in the job control file. 

If the user specifies the copy-named-files method for a tape-to-disk copy run, he must 
insure that the input tape is the product of a previous disk-to-tape copy run that also used the 
copy-named-files method. 

Precautions When Using Disk/Tape Copy C 

The user of Disk/Tape Copy C is responsible for maintaining a logical relationship between 
a volume directory and the files to which it refers. Specifically, the user must insure that the 
output mass storage volume directory accurately reflects all rectangles or named files that are 
copied to that volume. 

The volume directory is fully described in Appendix A of the Mod 1 (MSR) Data Management 
Subsystem manual. The volume label (cylinder 00, track 01, record 0 on the Type 155 Disk Pack 
Drive; cylinder 00, track 01 on all other mass storage devices) and the volume directory (cylin- 
der 00, track 01, records 1 through 14, and cylinder 01, tracks 00 and 01 on the Type 155 Disk 
Pack Drive; starts at cylinder 00, track 02 on all other mass storage devices) may be reviewed 
frequently by means of the map function of File Support C and Mass Storage Edit C. 

The following paragraphs describe precautions that must be taken under the copy-by- 
rectangle and copy-named-files methods when the output volume is mass storage. 

COPY-BY-RECTANGLE METHOD 

In Disk/Tape Copy C, rectangles copied to an output mass storage volume must be logically 
consistent with the output volume directory. The output volume directory must contain complete 
information for the file(s) to which the copied rectangle(s) belong(s). 

There are two conditions under which the output volume directory properly reflects the 
file(s) to which the copied rectangle(s) belong(s). 

1. When the file(s) has been previously allocated and loaded onto the current 
output volume (and not deallocated). The file(s) must have been allocated 
to the output volume exactly as allocated on the original input volume. 

2. When the input volume directory has been copied by rectangle to the output 
volume. 
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If the output volume directory does not describe the file(s) to which the copied rectangle(s) 
belong(s), the data cannot be processed after it is copied. It is not possible to allocate a file 
to the output mass storage volume after the data rectangles have been copied, since the data 
would be destroyed. 

If a copy-by-rectangle specifies only those tracks constituting the input volume directory, 
the data area(s) belonging to the file(s) in that volume directory are not automatically copied. 

To copy the data area(s) of file(s) described in the input volume directory, the user must include 
the appropriate FROM and TO parameters in the Input Volume statement (or, in a separate exe- 
cution of Disk/Tape Copy C, the user may include a File statement for each file described in the 
input volume directory). 

COPY -NAMED-FILES METHOD 

When the copy -named -files method is used, the file named in each File statement must 
already be allocated to the output mass storage volume with a structure identical with the file of 
the same name on the original input mass storage volume. When copied to the output mass 
storage volume, the named file occupies the same cylinder and track addresses occupied by the 
same file on the original input mass storage volume. 

A file cannot be copied to an output mass storage volume unless it is represented in the 
output volume directory exactly as it was allocated to the original input volume. If the volume 
directories have dissimilar entries for the named file, a halt or console message occurs. * 

JOB CONTROL LANGUAGE FOR DISK/TAPE COPY C 

In order to run Disk/Tape Copy C, a job control file consisting of a series of job control 
statements must be placed in the card reader. Each job control statement contains one or more 
parameters. 

In the following description of job control statements, the term "line" is the equivalent of 
one card in the job control file. 

Sequence of Job Control Statements 

Job control statements for Disk/Tape Copy C must appear in the following order: 

1. Execute statement (if the routine is loaded from mass storage), 

2. Input Volume statement (if present). 


Halts and console messages are described in "Operating Procedures for Disk/Tape Copy C, " 
later in this section. 
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3. File statement(s) (if present), 

4. Output Volume statement (if present), and 

5. Information File statement (if present). 

The Execute statement is required for every run of Disk/Tape Copy C when the routine is 
loaded from mass storage. All the other job control statements are optional, but each execution 
of the routine requires either the Input Volume statement or the Output Volume statement. 

The last line of the last job control statement must contain an E in its mark field or be 
followed immediately by a line with blanks in its operation code and operands fields and an E in 
its mark field. 

A detailed description of the job control statements follows. Four sample job control files, 
as they appear when written on Easycoder coding forms, also follow. 

Execute Statement 

The Execute statement is used only when Disk/Tape Copy C is loaded from mass storage. 

It directs the Supervisor to load Disk/Tape Copy C from the system disk. An Execute statement 
is required for every run of this routine when it is mass storage resident. 

An Execute statement is not used when Disk/Tape Copy C is loaded from magnetic tape. 
(For a description of loading from magnetic tape, see "Operating Procedures for Disk/Tape 
Copy C, " later in this section. ) 

The Execute statement is written as shown in Figure 6-4. 
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Figure 6-4. Execute Statement for Disk/Tape Copy C 
Input Volume Statement 

A complete Input Volume statement is shown in Figure 6-5. 
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Figure 6-5. Input Volume Statement for Disk/Tape Copy C 


The Input Volume statement is normally present in the job control file since the user 
usually will desire to specify a value for one or more of the statement's parameters. However, 
the Input Volume statement is not required. 

If the Input Volume statement is omitted, the default values for all its parameters are 
assumed. In addition, the Output Volume statement must be present if the Input Volume state- 
ment is omitted, and the output device must not be a Type 155 Disk Pack Drive. 

VOLUME -NAME PARAMETER 

The volume -name parameter (NAME) is optional. 

When the input is on mass storage, the volume-name parameter refers to the input volume 
name, and that name is checked before the copy is executed. 

When the input is on magnetic tape, the implication is that the tape is the product of a 
previous disk-to-tape copy run. At that time the name of the input mass storage volume was 
stored in character positions 52 through 57 of the tape header label. This name is now checked 
for equality with the name parameter. 

Use of this parameter insures that the correct input volume (disk or tape) is present. The 
form of this parameter is as follows. 

| NAME = volume-name, 
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volume -name = This name may be up to six characters in length. 

The default assumption is that no name GhecKing is required. 

DEVICE -TYPE PARAMETER 

The form of this parameter is as follows. 

j^DEVTYPE = device-type, ~ 

device -type = The type number of the device on which the input volume is 
mounted. 

The device type may be chosen from the following. 

I 


I When the value of the input device-type parameter is 155, the only permissible output 

device-type parameters are 155 or 204B. 

If the value of the input device-type parameter is 204B, the implication is that the tape-to- 
disk copy function is required. 

The default assumption is that the input device is a Type 259 Disk Pack Drive. 

DEVICE -ADDRESS PARAMETER 

The device -address parameter (DEVADD) specifies the address of the peripheral device on 
which the input volume is mounted. No more than one device-address parameter may be speci- 
fied for a mass storage device. When input is a multireel tape file, two tape device addresses 
(primary and alternate) may be specified to permit automatic progression from one tape to 
another. 


pcu - Peripheral control unit number, written as two octal characters. The 
I/O bit is irrelevant, but all other bits must be specified. 

drive - Drive number, written as one octal character. 


Tape 


DEVADD = (pcu, drive) , . . . 


Mass Storage 


DEVADD = (pcu, drive) , 


Device Type 


Medium 


1 


155 

258 

259 
273 
261 
262 
204B 


Mass Storage 
Mass Storage 
Mass Storage 
Mass Storage 
Mass Storage 
Mass Storage 
Magnetic Tape 


1 


When the input volume is mounted on a Type 259A 
or 259B Disk Pack Drive, the value 259 must be 
used in the device-type parameter. Omitting the 
device-type parameter will have the same result, 
since 259 is the default assumption. 
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Default A s sumption s : 

When input is on a mass storage device, the default assumption is pcu 44, drive 0. 

When input is on magnetic tape, the default assumption is pcu 40, drive 1. 

FROM AND TO PARAMETERS 

FROM and TO parameters are used only with the copy-by-rectangle method. If FROM and 
TO parameters are included in the Input Volume statement, no File statements can appear in the 
job control file. 

One pair of FROM and TO parameters describes one mass storage area (rectangle) to be 
copied as follows: (1) from an input mass storage volume onto an output magnetic tape or mass 
storage volume, or (2) from an input magnetic tape (the product of a previous disk-to-tape copy) 
onto an output mass storage volume. 

An Input Volume statement can contain up to 16 pairs of FROM and TO parameters. FROM 
and TO parameters must follow all other parameters of the Input Volume statement. The form 
of this parameter is shown below. 

j FROM = (ccc, ttt), TO = (ccc, ttt), . . . 

ccc = The cylinder address, in decimal, where leading zeros are not required. 

The first cylinder on the device is numbered zero. 

+++ = The track address, in decimal, where leading zeros are not required. 

The first track on each cylinder is numbered zero. 

One pair of FROM and TO parameters specifies that the following mass storage area is to 
be copied: all the tracks from the track stated in the FROM parameter to the track stated in the 
TO parameter (inclusive) on each cylinder from the cylinder stated in the FROM parameter to 
the cylinder stated in the TO parameter (inclusive). 

For example, the pair of FROM and TO parameters shown below specifies an area of tracks 
15 through 18 on cylinders 12 through 16, a total of 20 tracks. 

| FROM = (12, 15) , TO = (16, 18) , | 

When requesting the copy-by-rectangle method for either a disk-to-tape or a disk-to-disk 
copy run, the user must include at least one pair of FROM and TO parameters in the Input 
Volume statement. 

When requesting the copy-by-rectangle method for a tape -to -disk copy run, the user must 
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insure that each pair of FROM and TO parameters defines an area equal to or smaller than 
(i. e. , within) a rectangle or unit of allocation previously copied to the input tape. 

NOTES: 1. If the input volume is mass storage and no FROM and TO 
parameters are specified, one or more File statements 
must be included in the job control file to implement the 
copy-named-files method. 

2. If the input volume is magnetic tape and neither FROM 
and TO parameters nor File statements are specified, 
the same method used to create the tape will be used during 
the current tape-to-disk copy. However, all rectangles or 
all files originally copied to the tape will now be copied to 
the designated output mass storage volume. 


File Statement * 

The File statement is used only with the copy -named -files method. The format of the 
File statement is shown in Figure 6-6. 
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Figure 6-6. File Statement for Disk/Tape Copy C 


file-name = The name of the file to be copied (up to ten alphanumeric characters). 


When requesting a disk-to-tape copy or a disk-to-disk copy using the copy-named -files 
method, the user must include a File statement for each file that he desires to copy from the 
input disk. (No FROM and TO parameters may appear in the Input Volume statement during 
this execution.) During disk-to-disk copy, the user must insure that each file to be copied 
has been allocated to the output mass storage volume with a structure identical with that of the 
corresponding file on the input mass storage volume. 


When the user requests a tape-to-disk copy using the copy-named-files method, he must 


The following files and tracks cannot be copied by name and must not be named in File state- 
ments: (1) the volume directory files, (2) the *BADTRACKS and *VOLSPARES files (which are 
described in Appendix B of this manual), (3) the volume label track, (4) the bootstrap track, 
and (5) the substitute bootstrap track. 
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first insure that the input tape is the product of a previous disk-to-tape copy that used the copy- 
named-files method. A File statement is required for each file that is now to be copied to the 
output mass storage volume. (No FROM and TO parameters may appear in the Input Volume 
statement during this execution. ) The user must also insure that each file to be copied has been 
allocated to the output mass storage volume with a file structure identical with that of the corre- 
sponding file on the original mass storage volume (i. e. , the volume from which the previous 
disk-to-tape copy was made). 

NOTES: 1. If the input volume is mass storage and no File statements 

are included in the job control file, one or more pairs of 
FROM and TO parameters must appear in the Input Volume 
statement to implement the copy-by-rectangle method. 

2. If the input volume is magnetic tape and neither File statements 
nor FROM and TO parameters are included in the job control 
file, the implication is that the same method used to create the 
tape will be used during the current tape-to-disk copy run. 

However, all rectangles or all files originally copied to the tape 
will now be copied to the designated output mass storage volume. 


Output Volume Statement 


A complete Output Volume Statement is shown in Figure 6-7. 
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Figure 6-7. Output Volume Statement for Disk/Tape Copy C 


The Output Volume Statement is optional unless the Input Volume statement is omitted or 
the input device-type parameter value is 155. If the Output Volume statement is omitted, the 
default values for all its parameters are assumed. The Output Volume Statement must be in- 
cluded if the user desires to specify a value for one or more of its parameters. 

VOLUME -NAME PARAMETER 

The form of this parameter is as follows. 

|^^AME^=^olume-name^ 
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volume name = This name may be up to six characters in length. 


When an output volume is mass storage and an output volume name is specified, this name 
is checked prior to writing on the output volume; the device type of the output volume is also 
checked against that specified or defaulted. 


When the output volume is magnetic tape and an output volume name is specified, this name 
is checked prior to writing on the output volume. After the output volume name has been checked, 
the name of the input mass storage volume is entered into character positions 52 through 57 of 
the tape header label. 

Default Assumptions; 

When the output volume is mass storage, the default assumption is that the 
output volume name and device type are not to be checked. 

When the output volume is magnetic tape, the default assumption is that the 
output volume name is not to be checked. The name of the input mass storage 
volume is entered into character positions 52 through 57 of the tape header label. 


DEVICE-TYPE PARAMETER 

The form of this parameter is as follows. 


I DEVTYPE = device-type, 

device -type = The type number of the device on which the output volume is mounted. 


The device type may be chosen from the following. 


Device Type 

Medium 

155 

Mass Storage 

258 

Mass Storage 

259 1 

Mass Storage 

273 

Mass Storage 

261 

Mass Storage 

262 

Mass Storage 

20 4B 

Magnetic Tape 

*When the output mass storage volume is mounted 

on a Type 259A or 259B Disk Pack Drive, the 

value 259 must be used 

in the device-type parameter. 


I When the output device is a Type 155 Disk Pack Drive, the only permissible input device- 

type parameter values are 155 or 204B. 

When the output device is a magnetic tape unit, the implication is that the disk-to-tape copy 
function is required. 
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Default Assumptions: 

If the input volume is mass storage, the default assumption is that the output 
volume device type is the same as that specified, or defaulted, for the input 
volume. 

If the input volume is magnetic tape, the default assumption is that the output 
mass storage volume is on a Type 259 Disk Pack Drive. 


DEVICE -ADDRESS PARAMETER 

The form of this parameter is shown below. 


pcu = The peripheral control unit number, written as two octal characters. The 
I/O bit is irrelevant, but all other bits must be specified. 

drive = The drive number, written as one octal character. 


Mass Storage 


DEVADD = (pcu, drive), 


Tape 

j DEVADD = (pcu, drive), . . . 


Only one device-address parameter may be specified for a mass storage device. Two 
device-address parameters (primary and alternate) may be specified for a magnetic tape device. 

Default Assumptions: 

When the output volume is mass storage, the default assumption address is 
pcu 04, drive 0. 

NOTE: When performing a disk-to-disk copy, the input and output 
device addresses must not be identical. 

When the output volume is magnetic tape, the default assumption address is 
pcu 00, drive 1. 


Information File Statement 

The information file consists of printer messages that occur under certain conditions 
involving read and write errors. 1 The Information File statement is required only when the 
printer is assigned to a peripheral control unit whose address is not 02. 

If the Information File statement is omitted, the printer is assumed to be assigned to a 
peripheral control unit whose address is 02. 


These messages are described under "Information File Messages, " later in this section. 
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EASYCODER 

CODING FORM 

PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

| 

i 

LOCATION 

OPERATION 

CODE 

OPERANDS 


uukjuD 

□ 

□ 

8 . | . . .14 

1 5 1 20 



HI 

i 

i 




hhhhhhhhh 






* . ; ; : : : : 


HI 




File 

info. 


HI 

i 

G 



Mva&W.pauV_ . . . i 


m 

i 

1 

HH 

HI 

hmr —hi hi hh HH hh 

urdhrmh 


Figure 6-8. Information File Statement for Disk/Tape Copy C 


DEVICE -ADDRESS PARAMETER 

The device -address parameter (DEVADD) must be included when the Information File 
statement is used. This parameter specifies the address of the printer's peripheral control 
unit. The form of this parameter is shown below. 

| DEVADD = (pcu), 

pcu = The peripheral control unit number, written as two octal characters. 

All six bits must be specified. 


Sample Job Control Files 


The following sample job control files demonstrate four hypothetical copy situations. 


EXAMPLE 1 — DISK-TO-DISK COPY 


EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

T 

f 

1 

LOCATION 

OPERATION 

CODE 

OPERANDS 


no 

EJOD 

□ 

a 

8. , . . .14 

DHHHHE3 


63 .80 


rr 




E,Y . , . 

*R\scopy. i 

mHHHHHVHH 




i . . . 



■hhhhhhih 


i 







HHHHH HHH 


! 




mm 



■ 

HI 




mm 




HI 




mm 


H HH HH 


T 





NAttfe-,V0L2 ,, . . 





£ 



DEVA 



i 



. . 1 . . . 

i . . . . 

. i 1 .... 1 i ...... i . 1 ... i 1 ... i 1 i 

» -j i i — i — i — i — i — i i ■ i— i i . i i 


The action that has been requested is a disk-to-disk copy using the copy-named -files 
method. Both input and output device types are defaulted to Z59. Two files, named 
HONEYWELLA and HONEYWELLB, are to copied from a volume mounted on pcu 04, drive 1, 
to a volume mounted on pcu 04, drive 2. Before executing the copy, a check is to be made on 
the name of the output volume. 


6-16 


#3-619 









SECTION VI. DISK/TAPE COPY C 


EXAMPLE 2A — DISK-TO-TAPE COPY 

EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER OATE PAGE OF 


CARD 

NUMBER 

1 

IE3E1 

OPERATION 

COOE 

OPERANDS 


s 

1 

3 

□E 

2DMHR] 

15 j 20 



Ml 



(mu 

ift.is.copy... , . . . . . . . 

HMHHUHmm 

MM 





HHMMHHHHI 

MMI 




nraMMHmMM| 

HHHHHMHHI 

n 



file 


HHMHM MM 

MM 





HHHMI Ml 

m 




NAME-.V0LTRE, . . . 


mu 




DeVTVP£=2j&4£ r . . 


HUB 

r 

’■Ml 




HI 

I 

T 

Hi 

mi mi H ■ H M M HI 

HMHHM mHH 


The action that has been requested is a disk-to-tape copy using the copy-named-files 
method. A file named BLUBOY1234 is to be copied from a mass storage volume mounted on a 
Type 259 Disk Pack Drive (default value) whose address is pcu 44, drive 0 (default value). The 
output volume is a magnetic tape (since the output device type is specified as a Type 204B Mag- 
netic Tape Unit). The address of the tape unit is pcu 00, drive 1 (default value). Before executing 
the copy, a check is to be made on the names of the input and output volumes. 


EXAMPLE 2B — TAPE-TO-DISK COPY 

EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

I! 

f " LOCATION 

OPERATION 

CODE 

OPERANDS 


1 2 3 4 I 5 

6 

6. , . .14 

15, 20 

2 ‘- • • - I ■ • L. . 1 . ■ ■ ■ l 1 , , ...... . | 1 


S-L-l 


1 



EX 

*$ISC.0py. 









.! ! 



BSTOKi 

IN 







. 1 . 1 








, 

MAliAE=, VOLTPE, . . 







. 1 . . 









hEVTVPE =2^4£. . 





r 


. 1 . , 





1 1 

- .. 1 . 1 











. 1 . . 





1 1 




















QUTf. , 












1 




NAmI'.NEWjMAS. . 












it 




j 












— A— 1 — L 

L. 

• 1 . —A. 

i — . . 

— * . . . —1 . ■ , ■ i . . — ^-A. .1 , ... 1 ... 


■ 1 





■ L. ■ ■ 






The action that has been requested is a tape-to-disk copy using the copy-by-rectangle 
method. The input magnetic tape (named VOLTPE) is the product of the disk-to-tape copy run 
shown in Example 2A. As the result of that copy run, VOLTPE now contains the file named 
BLUBOY1234. The current example shows how a user can specify that only selected areas of a 
named file are to be copied to an output mass storage volume. (In this example, the two rectan- 
gles specified in the Input Volume statement must be equal to or smaller than (i. e. , within) two 
Emits of allocation of BLUBOY1234.) The resulting copy transfers only the specified areas 
(rectangles) of BLUBOY1234 to a mass storage volume named NEWMAS and mounted on a Type 
259 Disk Pack Drive (default value) whose address is pcu 04. drive 1. 
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EXAMPLE 4 — DISK-TO-TAPE COPY 


EASYCODER 

COOING FORM 


PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

T! 

!. 

LOCATION 

OPERATION 

CODE 

OPERANDS 


t 2 | 3 4l 5 

6 

8 i . . .14 

15, . . ,20 

2I - ....... I .... 1 .... 1 I .... 1 .... 1 .62 

“. !....«• 




ai 

♦DlfcCOPY. 


HI 


. . i . . . 

iSMiujy 


h m hh 

HI 

II 




mmPMMM 

■Ml 




b.EVTVPE« 2.6,1., ......... , . . , 

. . i . . . . . 

■1 




t>E.VAbW«S4, 2 ), , . . . 


m 







MRS 





IRM HI HH R 





F.g.OM» l (.6.0.,.L0). ) .T.O=.C3.<^,A^.Y, . . . 


1 



VOLUME 

OUT,. 


m 




bEVTY.PE=- 2$4B , . , , . , . ........... . , . 


MH 




b.E.VADP-/ $ 6 , 2 ) , >EVAD1>. (ehzS.,3) , 


. i . i 






- 44 - 



. . J . . ■ 

i .... 


— 1 — 


The action requested is a disk-to-tape copy using the copy-by-rectangle method. The 
output is expected to occupy multiple reels. 

PROGRAMMER'S PREPARATION INFORMATION 


Selecting the Desired Copy Option 

Disk/Tape Copy C offers three copy options to the user: disk-to-tape, tape-to-disk, and 
disk-to-disk. Each of the three copy options permits two copy methods: copy-by-rectangle and 
c opy -name d-file s . 

During a single run of Disk/Tape Copy C, only one copy option and only one copy method 
can be specified (e. g. , the disk-to-tape copy option using the copy-named-files method). The 
desired copy option and method are specified by the parameters supplied in the job control file, 
which is placed in the card reader. 


» 


Each of the three copy options is a separate segment of Disk/Tape Copy C. After the entire 
job control file for a run has been processed, the appropriate copy segment is loaded and executed. 

DISK-TO-TAPE OPTION 

This option is requested by indicating a mass storage device (either specified or defaulted) 
in the Input Volume statement and by specifying a tape device in the Output Volume statement. 
Either the copy-by-rectangle or the copy -named -files method must be specified. 

The copy-by-rectangle method is specified by including at least one pair of FROM and TO 
parameters in the Input Volume statement; a maximum of 16 pairs is allowed. The copy-named- 
files method is specified by including a File statement for every file to be copied; any number of 
File statements is allowed. 
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If the copy-by-rectangle method is specified, no File statements may appear in the job 
control file. If the copy-named-files method is specified, no FROM and TO parameters may 
appear in the Input Volume statement. 

TAPE -T O-DISK OPTION 

This option is requested by specifying a tape device in the Input Volume statement and by 
indicating a mass storage device (either specified or defaulted) in the Output Volume statement. 

If the input tape was created by a previous disk-to-tape copy run that used the copy-named- 
files method, either the copy-by-rectangle or copy-named-files method can be used during the 
current tape-to-disk copy run. If the copy-by-rectangle method is used, each pair of FROM and 
TO parameters must be equal to or smaller than (i. e., within) a unit of allocation of the named 
file. Only one pair of FROM and TO parameters can be specified for each unit of allocation that 
is to be copied from the input tape. 

If the input tape was created by a previous disk-to-tape copy run that used the copy-by- 
rectangle method, only that method can be used during the current tape-to-disk copy run. If 
desired, the current copy can include only selected rectangles, parts of selected rectangles, or 
parts of all rectangles previously copied to the input tape. 

If neither the copy-by-rectangle nor copy-named-files method is specified (i.e., the job 
control file contains neither FROM and TO parameters nor File statements), the input tape will 
be copied to the output mass storage volume by the same method used in the previous disk-to-tape 
copy run. However, all rectangles or all files will be copied in their entirety to the output mass 
storage volume. 

DISK -TO - DISK OPTION 

This option is requested by indicating a mass storage device (either specified or defaulted) 
in both the Input and Output Volume statements. Either the copy-by-rectangle or the copy-named- 
files method must be specified. The requirements and restrictions involved in specifying the 
copy method are identical with those previously described for the disk-to-tape copy option. 

Device Usage 

In a single execution of Disk/Tape Copy C, only one device address may be specified for 
each mass storage volume involved. Thus, a maximum of two mass storage volumes may be 
specified: one as input and one as output. 
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When processing tape as input or output, two device addresses (one primary and one 
alternate) may be specified to facilitate multireel processing. Regardless of whether an alter- 
nate tape device address is specified, multireel tape processing can be performed. Multireel 
tape input requires that the reels be mounted in proper sequence as indicated by their reel 
sequence numbers. 

Magnetic Tape Usage 

Disk-to-tape and tape-to-disk copy functions of Disk/Tape Copy C require the use of 
1 /2-inch magnetic tapes mounted on Type 204B Magnetic Tape Units. When the tape-to-disk 
copy function is desired, the input tape must be the product of a prior disk-to-tape run of the 
routine. 

Tapes are written in odd parity with bannered records. 

TAPE HEADER LABEL 

The tape header label is 80 characters in length and is the first record on the tape. Its 
format is shown in Table 6-1. 


Table 6-1. Tape Header Label 


Character Positions 

Contents 

1-5 

1 HDRA 

6-16 

Unused (preserved on output) 

17-19 

Reel Sequence Number 

20 

R, F, or Blank* 

21-30 

*DISKCOPY* 

31-50 

Unused 

51 

Mass Storage Device Type 

52-57 

Volume Name 

58-80 

Reserved for future use 


R = the tape is output from a copy-by-rectangle 
execution. 

F = the tape is output from a copy-named-files 
execution. 

Blank = the tape is output from the previous version 

(copy-by-rectangle) of Disk/Tape Copy C. In 
this case, all rectangles on the input tape are 
copied during the tape-to-disk copy run. (No 
FROM and TO parameters should be included 
in the Input Volume statement. ) 
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TAPE DATA RECORDS 

When an input mass storage volume is copied onto an output tape (regardless of the copy 
method used), each full track of input information (including header areas and track-linking 
records) is written as a single record onto the tape. Each tape record has a banner character 
of 41 (octal). 

The format of a sample tape record is shown in Figure 6-9. Assume that the input device 
is a Type 259 Disk Pack Drive and that an input track contains three 1500-character records and 
a track-linking record. 



Figure 6-9. Sample Tape Record 


TAPE TRAILER LABEL 

The trailer label is 80 characters in length and must be the first record after the last data 
record on the tape. Its format is shown in Table 6-2. 


Table 6-2. Tape Trailer Label 



Character Positions 

Contents 


1-5 

lEOFAor IE ORA 


6-80 

Unused 


A 1EORA trailer label (followed by two 1ERI records) is written after the last data record 
on an intermediate reel of output tape for a given copy run. 

A 1EOFA trailer label (followed by two 1ERI records) is written after the last data record 
on the last reel of output tape for a given copy run. 
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TAPE FORMATS 

A disk-to-tape copy using either the copy-by-rectangle or the copy-named-files method 
produces a nonstandard tape format. 

Tape Format (Tape Created by Copy-by-Rectangle Method) 

The following format appears on the first reel of output tape after a disk-to-tape copy run 
that used the copy-by-rectangle method. 

1. The tape header label 

2. An index of the rectangles copied to the output tape(s) 

3. A rectangle identification record for one rectangle 

4. Data records for this rectangle 

(Items 3 and 4 are repeated for each rectangle 
copied to this reel) 

5. The tape trailer label (followed by two 1ERI records) 

If the first reel of output tape is filled before the copy is completed, a second reel of tape 
is required. The format of the second reel (and any additional reels necessary) is the same as 
the format of the first reel except that item 2 is not present. 

Tape Format (Tape Created by Copy-Named-Files Method) 

The following format appears on the first reel of output tape after a disk-to-tape copy run 
that used the copy-named-files method. 

1. The tape header label 

2. A file index record for each file copied to the output 
tape(s) 

3. A file identification record for one file 

4. A unit of allocation record for this file 

5. Data records for this file 

(Items 4 and 5 are repeated for each unit of allocation 
in the first file copied to this reel. If more than one 
file is copied to this reel, a file identification record 
(item 3) appears before the first unit of allocation rec- 
ord (item 4) for each new file) 

6. The tape trailer label (followed by two 1ERI records). 

If the first reel of output tape is filled before the copy is completed, a second reel of tape 
is required. The format of the second reel (and any additional reels necessary) is the same as 
the format of the first reel except that item 2 is not present. 
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MULTIREEL OUTPUT 

Multireel output usually occurs only when copying from Type 261 or 262 Disk Files. An 
intermediate output reel is terminated by a 1EORA trailer label followed by two 1ERI records. 
The tape is rewound and released. 

If an alternate tape drive has been specified, processing automatically continues on the 
alternate tape. 


If no alternate tape drive has been specified, the operator must mount a new tape on the 
same device address before continuing. 


The final output reel is terminated by a 1EOFA trailer label followed by two 1ERI records. 


Volume Name Processing 


Disk/Tape Copy C incorporates the following checks to determine whether the proper input 
and output volumes are being used. 


TAPE INPUT 

The header label of an input tape is checked in the sequence outlined below. 

1. Character positions 1 through 5 of the tape header label are checked for the 
presence of 1HDRA. If equality results, processing continues to step 2, 
below. If inequality results, a halt or console message occurs: the user 
has the option to mount a new tape and try again. 

2. Character positions 21 through 30 are checked for the presence of 
*DISKCOPY*. If inequality results, the tape will not be accepted as 
input and a halt or console message occurs: the user has the option to 
mount a new tape and try again. If equality results from the *DISKCOPY* 
check and an input volume name has been specified, processing continues 
to step 3. If equality results from the *DISKCOPY* check and no input 
volume name has been specified, processing continues to step 4 (the input 
volume name is not checked). 

3. Character positions 52 through 57 are checked for equality with the speci- 
fied input volume name. If equality results, processing continues to step 

4. If inequality results, a halt or console message occurs: the user has 
the option to mount a new tape and try again. 

4. Character position 51 is checked for compatibility with the output mass 
storage device type. If compatibility exists, processing continues to step 

5. If compatibility does not exist, a halt or console message occurs: the 
user has the option to mount a new tape and try again. 

5. Character positions 17 through 19 are checked for the proper reel sequence 
number. If the proper number is present, the tape is acceptable and pro- 
cessing continues. If the proper number is not present, a halt or console 
message occurs: the user may mount a new tape reel and try again or he 
may accept the present tape as input to the run. 
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TAPE OUTPUT 

If no name parameter is specified for the output tape, no checking is done on the output 
tape header label. Instead, a standard Disk/Tape Copy tape header label is created as shown 
previously in Table 6-1. The name of the input mass storage volume is entered into character 
positions 52 through 57. 

If the name parameter^ specified for the output tape, the output tape header label is 
checked. The contents of character positions 52 through 57 must equal the specified name. 

Any invalid contents in the tape header label result in a halt or console message. The user 
has the option to mount a new output tape and try again or to accept the present output tape. 

After the check of the output tape header label is completed, the input mass storage device 
type is entered into character position 51 and the input volume name is entered into character 
positions 52 through 57. 

MASS STORAGE INPUT 

If the name parameter is specified for the input mass storage volume, the volume name is 
checked. If it is incorrect, a halt or console message occurs: the user may mount a new volume 
and try again. 

MASS STORAGE OUPUT 

If the name parameter is specified for the output mass storage volume, the volume name 
is checked. The resultant action parallels that for mass storage input. 

Mass Storage Device Type Check 

Whenever a mass storage volume name is checked, the device type (either specified or 
defaulted) in the same Input or Output Volume statement is also checked against the device type 
indicated on the volume label. 

OPERATING PROCEDURES FOR DISK/TAPE COPY C 
Loading Disk /Tape Copy C 

Disk /Tape Copy C can be loaded in two ways: 

1. From mass storage, via the Supervisor under the Mod 1 (MSR) Operating 
System; 

2. From magnetic tape, via Floating Tape Loader -Monitor C under the Mod 1 
(TR) Operating System. 
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MASS STORAGE RESIDENT 

When the routine is loaded from mass storage, an Execute statement (as illustrated in 
Figure 6-4) must be submitted in the job control file, followed by the desired job control state- 
ments for the routine. 

TAPE RESIDENT 

Loading the routine from magnetic tape is the same as loading from mass storage, except 
that a console call card is used instead of an Execute statement. The format of the console call 
card is shown in Table 6-3. 


Table 6-3. Console Call Card Format 


Characters 

Contents 

Meaning 

1-8 

*DISCOPY 

Program and segment names 
of Disk/Tape Copy C. 

9 

d 

Tape drive number from which 
Disk /Tape Copy C is to be loaded. 

18 

* 

Asterisk (required by the Mod 
1 (TR) Operating System). 


Protection Switch Settings 

Protection switches on mass storage control units must be set as follows: 

Disk-to-tape copy — • all switches may be set to PROTECT.* 

Tape -to -disk copy — all switches must be set to PERMIT. 

Disk-to-disk copy: 

Input volume — all switches may be set to PROTECT (when separate 
control units are used for input and output mass 
storage devices). 

Output volume all switches must be set to PERMIT. 

2 

Processing Bad Areas of a Volume 

During various runs of Disk/Tape Copy C, the user may at times encounter (1) uncorrect- 
able read errors on input disk tracks or tape records, or (2) uncorrectable write errors on out- 
put disk tracks or tapes. The following two rules describe various possible read and write error 


When partitioned sequential files are being copied by the copy-named-files method, protection 
switches on mass storage control units must be set to PERMIT . 

2 See "Bad Track Handling Procedures for Disk/Tape Copy C" in Appendix B if the *BADTRACKS 
and *VOLSPARES files are present on a mass storage volume. 
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conditions. In addition. Table 6-4 provides a useful summary of these conditions. 

1. A halt or console message occurs under the circumstances outlined below. 

The action and printer message that will be produced by an A response 

depend on which type of error condition is present. 

a. If an input disk track contains data or one or more bad-track 
TLR's and cannot be successfully read, a halt or console 
message occurs. If an A response is given, a Dad-track 
TL<R is written onto the output volume and a BAD TRACK 
TLR message appears on the printer/ If the unreadahle 
input track occurs at the beginning or in the middle of the 
area being copied, the bad-track TLR copied to the output 
volume links to the next consecutive track address within 
the area. If the unreadable input track is the last track of 
an area being copied, the bad-track TLR links to the next 
physical track address (outside the area). 

b. If an input tape record containing data or one or more bad- 
track TLR's cannot be read successfully, a halt or console 
message occurs. One can determine the address of the last 
track (tape record) that was successfully copied onto the 
output disk by consulting the mass storage cylinder and 
track address field of the supplementary list (see Table 
6-5). If an A response is given, no further action occurs 
on the output disk for the defective input tape record and a 
SUBSEQUENT TRACK MISSING message appears on the 
printer. 

Normally, the missing track occupies the next consecutive 
physical address following the track listed in the SUBSEQUENT 
TRACK MISSING message. In some cases, however, the 
missing track does not occupy the next consecutive physical 
address. To check the address of the missing track, the user 
should always refer to the FROM and TO parameters used 
to create the input tape. 

c. If a disk output write error exists, a halt or console message 
occurs. If an A response is given, the copied data remains 
on the faulty output disk track and a FORMAT BAD message 
appears on the printer. 

2. No halt oar console message occurs and a BAD TRACK TLR message appears 

on the printer under the following circumstances: 

a. If an input tape record contains one or more bad-track TLR's 
and can be read and copied successfully. (The track linkage 
is the same as that shown in item la, above. ) 

b. If an input disk track contains one or more bad-track TLR's 
and can be read and copied successfully. (The track indi- 
cated by the bad-track TLR('s) is copied to the output volume. 

If the output volume is magnetic tape, the header areas of the 
tape record are modified to show the address of the bad track 
itself. If the output volume is mass storage, tne track indi- 
cated by the bad-track TLR ( ' s) is copied to the output disk 
track whose address corresponds to that of the bad input track. ) 

The complete format and explanation of each printer message appears in this section under the 
paragraph, "Information File Messages." 
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Whenever information is lost because of read or write errors, the cylinder and track 
address(es) affected should be noted for analysis of the volume's future usability. 

The effect of a lost track may be minimal, but, depending on the information it contains, 
its loss could prevent future runs. For this reason, avoid skipping any track whose utilization 
is unknown. 


Track utilization and contents are determined by the map function ("description" and 
"unused" options) of File Support C and Mass Storage Edit C. 


Table 6-4. Summary of Read/Write Conditions 



Disk Input 

Tape Input 

Read Error 

Good Read 

Read Error 

Good Read 

Data or Bad-Track 
TLR('s) 

Data 

Bad-Track 

TLR('s) 

Data or Bad-Track 
TLRfB) 

Data 

Bad-Track 

TLR('s) 

o 

D U 
I T 

S P 
K U 
T 

Good W rite 

Halt or console 
message + BTTLR 


The track indicated 
by the bad-track 
TLR('s) is copied 
to the output disk 
track whose ad- 
dress corresponds 
to that of the orig- 
inal bad track. 
BTTLR 

Halt or console 
message + STM 


BTTLR 

Write Error 

Halt or console 
message + BTTLR 

Halt or console 
message + FB 

Halt or console 
message + FB 

Halt or console 
message + STM 

Halt or console 
message + FB 

Halt or console 
message + FB 

O 

T U 
A T 
P P 
E U 
T 

Good W rite 

Halt or console 
message + BTTLR 


The track indicated 
by the bad-track 
TLR('s) is copied. 
Header areas of 
the output tape rec- 
ord are modified to 
show the address 
of the bad track it- 
self. BTTLR 


Write Error 

If a tape write error occurs, it is accompanied by a halt 
or a console message. The user may attempt to rewrite 
the tape record (G response) or exit to the Supervisor 
(E response). 


A halt or console message occurs only where indicated. The following abbreviations are used for printer messages: 

BTTLR = a BAD TRACK TLR message. 

FB = a FORMAT BAD message. 

STM = a SUBSEQUENT TRACK MISSING message. 


INFORMATION FILE MESSAGES 

The information file is a listing on the printer of the BAD TRACK TLR, FORMAT BAD, 
and SUBSEQUENT TRACK MISSING messages that may occur during an execution of Disk/Tape 
Copy C. Each message provides a cylinder and track address in the following format: 

CYL nnn TR nnn 

nnn is a decimal value. The complete format of each message appears below. 

1. CYL nnn TR nnn — BAD TRACK TLR 

2. CYL nnn TR nnn — FORMAT BAD 

3. CYL nnn TR nnn — SUBSEQUENT TRACK MISSING 
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Operator Communication and Control 

When an error condition occurs, 2-way communication between the operating system and 
the operator is achieved through a control panel £r (if certain software and hardware requirements 
have been met) through a console. If the communication medium is a control panel, an error con- 
dition causes the central processor to halt. If the communication medium is a console, an error 
condition causes a message to appear, but the central processor does not halt. 

Halts or console messages are caused by three types of error conditions: peripheral device 
conditions, job control file conditions, and conditions specific to Disk/Tape Copy C. When a halt 
or console message occurs, the operator must determine which error condition exists and then 
make the appropriate response. 

CONTROL PANEL HALTS 

At the time of a control panel halt, the B-address register contains a value that identifies 
the error condition. In most cases, the A-address register contains the address of a response 
location in main memory. The response location is a 1 -character main memory location into 
which the operator must enter a response character appropriate to the error involved. Where 
indicated, additional information concerning the error can be found in the main memory locations 
immediately following the response location. This additional information is called the supple- 
mentary list (see Table 6-5) and is composed of the following elements (arranged in ascending 
order of contiguous main memory locations). 


Table 6-5. Supplementary List 


Field Name 

Length 

Specific code location 

One character (A+l) 

Input volume name 

Six characters 

Input device type 1 

One character 

Input pcu address 

One character 

Input device address 

One character 

Input magazine address 

One character 

Output volume name 

Six characters 

Output device type 1 

One character 

Output pcu address 

One character 

Output device address 

One character 

Output magazine address 

One character 

Mass storage cylinder 

Six characters in the 

and track address^ 

decimal format cccttt 

File name (if applicable) 

Ten characters 
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Table 6-5 (cont). Supplementary List 


^The device types have the values shown below. 
^Significant only for mass storage peripheral errors. 


Value | 

Device Type 

Octal 

Alphanumeric 

155 

21 

A 

258 

11 

9 

259 

12 

1 

273 

13 

= 

261 

31 

I 

262 

32 

t 

26 1L 

33 

• 

262L 

34 

) 

204B 

63 

T 


The following paragraphs provide detailed information about the three types of error con- 
ditions when the operator's control unit is the control panel. 

Peripheral Device Halts 

A B-address register value in the range from 0000 through 3777 indicates an error condi- 
tion involving a peripheral device. The B-address register has the general form ppxd, 
pp = Peripheral control unit; 
x = Code indicating type of halt condition; 

0 = Device not operable, 

1 = Uncorrectable read error, 

2 = Uncorrectable write error, 

3 = End of storage medium, 

4 = Positioning or addressing error, and 
7 = Miscellaneous condition; 

d = Device number. 

These values are consistent with the standard peripheral error halt codes. 

When a peripheral device error causes a halt, the operator first must determine which 
peripheral control unit is involved. If "pp" in the B-address register indicates the control unit 
of a mass storage device, the operator should consult Table 6-6 to learn why the halt has 
occurred and what action he can take. If "pp" in the B-address register indicates the control 
unit of a device other than mass storage, the operator should consult Table 6-7. 

When the halt condition involves the card reader, the A-address register doe-s not contain 
meaningful values. In all other cases, the A-address register contains the response location. 
The supplementary list is also present (see Table 6-5). 
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Table 6-6. Mass Storage Peripheral Device Halts 


B-Address 

Register 

Contents 

Specific 

Code 

(A+l) 

C ondition 

Operator Action* 

ppOd 

01 

Device inoperable. 

G = retry. 


02 

Protection violation. 

E = exit to the Supervisor. 

ppld 

07 

Read error. 

G = retry. 

A = go on to the next track 
in the current rectan- 
gle or unit of allocation. 

E = exit to the Supervisor. 

pp2d 

04 

Write error. 

Same as for ppld. 

pp4d 

03 

05 

Positioning or 
addressing error: 

Device error - unable 
to position to desired 
cylinder. 

The addressed record 
has not been located. 

G = retry. 

E = exit to the Supervisor. 

pp6d 

06 

Record ignored due 
to misread, or cor- 
rupt address mark. 

G = retry. 

E = exit to the Supervisor. 

pp7d 

11 

Miscellaneous device 
error condition - 
possible device, failure . 

G = retry. 

E = exit to the Supervisor. 

I The operator must insert the appropriate response character into the response 

| location and press RUN (G = 

27 g , E = 25g, A = 21g). 

. 


Table 6-7. Non Mass Storage Peripheral Device Halts 


B-Address 

Register 

Contents 

A-Addres s 
Register 
Contents 

Condition 

Operator Action 

ppld 

If pp = magnetic tape, 
response location. 

Read error. 

1. To reattempt reading, enter 
G into response location and 
press RUN. 

2. To bypass record and go on 
to next record, enter A in- 
to response location and 
press RUN. 
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Table 6-7 (cont). Non Mass Storage Peripheral Device Halts 


B-Address 

Register 

Contents 

A-Address 

Register 

Contents 

Condition 

Operator Action 

ppld 

(cont) 


Read error. 

3. To exit to the Supervisor, 
enter E into response lo- 
cation and press RUN. 

If pp = card reader, 
0000. 

Correct erroneous card, if 
possible; refeed cards, 
starting with that card, and 
press RUN. 

pp2d 

If pp = magnetic tape, 
response location. 

Write error. 

1. To reattempt writing, enter 
G into response location 
and press RUN. 

2. To exit to the Supervisor, 
enter E into response 
location and press RUN. 

If pp = printer, re- 
sponse location. 

An erroneous line has 
been printed. To ignore 
error and go on to the next 
line, enter G into response 
location and press RUN. 

pp3d 

pp = magnetic tape, 
response location. 

End-of-reel. 

(Occurs only when an 
alternate tape ad- 
dress has not been 
specified. ) 

1. To continue, when next reel 
is ready, enter G into re- 
sponse location, and press 
RUN. 

2. To exit to the Supervisor, 
enter E into response 
location and press RUN. 

NOTE: G = 27 , E = 25 , A = 21 . 

o o o 


Job Control File Halts 

A B -address register value in the range from 5000 through 5077 indicates an error condi- 
tion related to the statements of the job control file. The A-address register contains the address 
of the response location. The operator decides what action is required and enters the appropriate 
response character into the response location (see Table 6-8). No supplementary list is produced. 

Halts Specific to Disk/Tape Copy C 

A B-address register value in the range from 6530 through 6547 indicates an error condi- 
tion that is specific to Disk/Tape Copy C. The A-address register contains the address of the 
response location. The supplementary list is also present (see Table 6-5). 

To determine the reason for the halt and the possible responses he may make, the opera- 
tor should consult Table 6-9. 
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Table 6-8. Job Control File Halts 


B-Address 

Register 

Contents 

Condition 

Operator Action 

5000 

Syntactic error. 

G = Attempt to perform the 
operation again. The 
operator corrects the 
erroneous card, 
if possible: refeeds the 
job control statements, 
excluding the Execute 
statement; enters a G 
into the response loca- 
tion and presses RUN. 
The program then re- 
processes the job con- 
trol file. 

E = Exit to the Supervisor. 

5001 

Invalid command 
field. 

5002 

Invalid positional 
parameter. 

5003 

Invalid keyword. 

5004 

Required parameter 
missing. 

5005 

Invalid keyword 
parameter value. 

5010 

Invalid combination or 
sequence of param- 
eters. 

5040 

Same as 501 0. 

tfSiifiliiii | 

NOTE: G = 27 0 , E = 25.. 

O O 


Table 6-9. Halts Specific to Disk/Tape Copy C 


B-Address 

Register 

Contents 

Specific 

Code 

(A+l) 

Condition 

Operator Action^ 

6530 


Wrong input volume mounted 
(name check failed). 

G = reopen the volume. 

E = exit to the Supervisor. 

6531 


Wrong output volume mounted 
(name check failed). 

G = reopen the volume. 

E = exit to the Supervisor. 

6532 


Tape reel sequence number is 
incorrect. 

G = reopen the current 
reel. 

A = accept the current 
reel. 

E = exit to the Supervisor. 

6533 


Either the input mass storage 
device type is not as specified 
(or defaulted) in the job control 
file, or the device type speci- 
fied in character position 51 of 
the input tape header label is 
incompatible with the output 
mass storage device. 

G = reopen the input 
volume . 

E = exit to the Supervisor. 
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Table 6-9 (cont). Halts Specific to Disk/Tape Copy C 


B-Address 

Register 

Contents 

Specific 

Code 

(A+l) 

Condition 

Operator Action^ 

6534 


Output mass storage device is 
not as specified (or defaulted). 

G = reopen the mass 
storage volume. 

E = exit to the Supervisor. 

6535 


The input tape header label 
is invalid. 

G = mount correct tape 
and retry. 

E = exit to the Supervisor. 

6536 


The output mass storage vol- 
ume is the volume from which 
the system has been loaded. 

G = refeed from the first 
volume statement. 

A = accept the situation. 

E = exit to the Supervisor. 

6537 


Insufficient memory is 
available. 

Type 155, 258, 259, and 273 
Disk Pack Drives require 
12, 288 characters of main 
memory. Type 261 and 262 
Disk Files require 20, 480 
characters of main memory. 

E = exit to the Supervisor. 

6540 

01 

File name not found on the 
input mass storage or tape 
volume. 

G = mount correct volume 
and retry. 

A = go to the next file. 

E = exit to the Supervisor. 

02 

File name not found on output 
mass storage volume. 

03 

Conflicting units of allocation 
or file descriptions. 

04 

File requested to be copied 
begins on a previous reel 
(reel mounted out of sequence). 

05 

File being copied does not con- 
tinue on the current reel (reel 
mounted out of sequence). 

06 

A discrepancy exists in the 
file description index of the 
output mass storage volume 
during a tape-to-disk copy 
run. The condition has devel- 
oped while an attempt is being 
made to copy all files from the 
input tape (the tape was created 
by the copy-named-files method 
and neither FROM and TO pa- 
rameters nor File statements 
were specified in the job control 
file for the current run). 

G = mount correct tape 
and retry. 

E = exit to the Supervisor. 
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Table 6-9 (cont). Halts Specific to Disk/Tape Copy C 


B-Address 

Register 

Contents 

Specific 
Code 
(A + l) 

Condition 

Operator Action^ 

6540 

(cont) 

07 

Error in the volume directory. 

G = mount correct 

volume and retry. 

A = go to the next file. 

E = exit to the Supervisor. 

40 

No files can be processed. 
(None of the files designated 
in File statements has been 
found on both the input and 
output volume s . ) 

G = mount correct 

volume and retry. 

E = exit to the Supervisor. 

6541 

01 

This rectangle cannot be 
processed. 

G = mount correct 

volume and retry. 

A = go to the next rectangle 

E = exit to the Supervisor. 

04 

Rectangle requested to be 
copied begins on a previous 
reel (reel mounted out of 
sequence). 

05 

Rectangle being copied does 
not continue on the current 
reel (reel mounted out of 
sequence). 

40 

No rectangles can be pro- 
cessed. (All of the rec- 
tangles designated in FROM 
and TO parameters include 
tracks outside the rectangles 
extant on the input tape 
volume. ) 

G = mount correct 

volume and retry. 

E = exit to the Supervisor. 


The operator must insert the appropriate response character into the response location 

and press RUN (G = 27 0 , E= 25 0 , A = 21J. 

o o o 


CONSOLE MESSAGES 

The console can be used for operator control when the Supervisor (in the Mod 1 (MSR) 
Operating System) or Floating Tape Loader -Monitor C (in the Mod 1 (TR) Operating System) has 
been appropriately specialized and when at least 16, 384 characters of main memory are 
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available. If either of these two conditions is not met, the operator's control medium is the 
control panel. 

When the console is used for operator control, an error condition does not cause the sys- 
tem to halt. Instead, diagnostic messages are typed out on the console. The operator takes the 
following steps. 

1. He reads the typeout. (To repeat the message, he presses the space 
bar twice.) If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1 -character response (G, E, etc.). 

4. If the typein is correct, he presses the space bar to continue. If it is 
incorrect, he types any nonspace character and returns to step 3. 

The routine continues as directed by the response code. If an invalid response is made, the 

routine causes the diagnostic message to reappear. 

The following paragraphs provide detailed information about the three kinds of messages: 
peripheral device messages, job control file messages, and messages specific to Disk/Tape 
Copy C. 

Peripheral Device Messages 

Console messages specific to peripheral device error conditions are listed in Tables 6-10 
and 6-11. The format of these messages is: 
pp d MESSAGE TEXT 
where: pp = Peripheral control unit, 
d = Drive number, and 

MESSAGE TEXT specifies the error condition. 

A second line of typed information contains the supplementary list described in Table 6-5. 

If "pp" indicates the control unit of a mass storage device, the operator should consult 
Table 6-10. If "pp" indicates the control unit of a device other than mass storage, the operator 
should consult Table 6-11. 


1 

When a Type 261 or 262 Disk File is used, the main memory requirement is always 20,480 
characters. 


6-35 


# 3-619 


SECTION VI. DISK/TAPE COPY C 


Table 6-10. Mass Storage Peripheral Device Messages 


Typewriter Message 

Specific Code^ 
(alphanumeric ) 

C ondition 

2 

Operator Action 

pp d INOPERABLE 

1 

Device inoperable. 

G = retry. 


2 

Protection violation. 

E = exit to the Supervisor. 

pp d READ ERROR 

7 

Read error. 

G = retry. 




A = go on to the next track 
in the current rectangle 
or unit of allocation. 




E = exit to the Supervisor. 

pp d WRITE ERROR 

4 

Write error. 

Same as for read error. 

pp d POSITIONING ERROR 

3 

Positioning or 
addressing error: 

Device error — 
unable to position 
to desired cylinder. 

G = retry. 

E = exit to the Supervisor. 


5 

The addressed 
record has not 
been located. 


pp d MISREAD ADDRESS 
MARK 

6 

This device has 
not recognized a 
record header. 

G = retry. 

E = exit to the Supervisor. 

pp d MISCELLANEOUS 

9 

Miscellaneous 
device error con- 
dition — possible 
device failure. 

G = retry. 

E = exit to the Supervisor. 

*The specific code is the first character of the supplementary list. 

2 

The operator types the appropriate response character and presses the space bar. 

Table 6-11. 

Non Mass Storage Peripheral Device 

Messages 


Typewriter Messages 

Condition 

Operator Action 

pp d READ ERROR 

Read error. 

1 . 

To reattempt reading, type G 

If pp = magnetic tape 



and press space bar. 



2. 

To bypass record and go on to 
next record, type A and press 
space bar. 



3. 

To exit to the Supervisor, type 
E and press space bar. 

If pp = card reader 


Correct erroneous card, if possible; 
refeed cards, starting with that card, 



and 

press space bar. 
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Table 6-11 (cont). Non Mass Storage Peripheral Device Messages 


Typewriter Messages 

Condition 

Operator Action 

pp d WRITE ERROR 
If pp = magnetic tape 

Write error. 

1 . To reattempt writing, type G 
and press space bar. 

2. To exit to the Supervisor, type 
E and press space bar. 

If pp = printer 

An erroneous line has been printed. 
To ignore error and go on to next 
line, press space bar. 

pp d END VOLUME 
If pp = magnetic tape 

End-of-reel. 

(Occurs only when 
an alternate tape 
address has not 
been specified. ) 

1. To continue, when next reel is 
ready, type G and press space 
bar. 

2. To exit to the Supervisor, type 
E and press space bar. 


Job Control File Messages 

All messages involving errors in the job control file begin with the words JOB CONTROL 
FILE ERROR. Table 6-12 contains the complete texts of all job control file messages for 
Disk/Tape Copy C. No supplementary list is produced. 


Table 6-12. Job Control File Messages 


Typewriter Message 

C ondition 

Operator Action 

JOB CONTROL FILE ERROR, 
SYNTAX 

Syntactic error. 

1. Correct the erroneous 
card, if possible; refeed 
the job control state- 
ments, excluding the 
Execute statement; type 
G and press the space 
bar. 

2. If the error cannot be 
corrected, type E and 
press the space bar. 
Control returns to the 
Supervisor. 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Invalid command field. 

JOB CONTROL FILE ERROR, 
POSITIONAL PARAMETER 

Invalid positional 
parameter. 

JOB CONTROL FILE ERROR, 
KEYWORD PARAMETER 

Invalid keyword. 

JOB CONTROL FILE ERROR, 
MISSING PARAMETER 

Required parameter 
missing. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Invalid keyword 
parameter value. 

JOB CONTROL FILE ERROR, 
PARAMETER COMBINATION 

Invalid combination or 
sequence of parameters. 

JOB CONTROL FILE ERROR, 
CANNOT REFEED, PARAM- 
ETER COMBINATION 

Invalid combination or 
sequence of parameters. 

The operator must type E and 
press the space bar. Control 
returns to the Supervisor. 
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Messages Specific to Disk/Tape Copy C 

Table 6-13 contains messages for error conditions specific to Disk/Tape Copy C. The 
typewriter messages in Table 6-13 are followed by a second line of typed information, which 
contains the supplementary list described in Table 6-5. 


Table 6-13. Messages Specific to Disk/Tape Copy C 


Typewriter Message 

Specific Code 
(alphanumeric ) 

Condition 

Operator Action* 

INPUT VOLUME 
NAME WRONG 


W rong input volume mounted 
(name check failed). 

G = reopen the 
volume . 

E = exit to the 
Supervisor. 

OUTPUT VOLUME 
NAME WRONG 


Wrong output volume mounted 
(name check failed). 

G = reopen the 
volume . 

E = exit to the 
Supervisor. 

REEL SEQUENCE 
CHECK FAILED 


Tape reel sequence number 
is incorrect. 

G = reopen the 

current reel. 

A = accept the 

current reel. 

E = exit to the 
Supervisor. 

WRONG INPUT 
DEVICE TYPE 


Either the input mass storage 
device type is not as speci- 
fied (or defaulted) in the job 
control file, or the device 
type specified in character 
position 51 of the input tape 
header label is incompatible 
with the output mass storage 
device. 

G = reopen the 

input volume. 

E = exit to the 
Supervisor. 

WRONG OUTPUT 
DEVICE TYPE 


Output mass storage device 
is not as specified (or de- 
faulted). 

G = reopen the mass 
storage volume. 

E = exit to the 
Supervisor. 

INVALID TAPE 
FORMAT 


The input tape header label 
is invalid. 

G = mount correct 
tape and retry. 

E = exit to the 
Supervisor. 
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Table 6-13 (cont). Messages Specific to Disk/Tape Copy C 


Typewriter Message 

Specific Code 
(alphanumeric ) 

Condition 

Operator Action 1 

SYSTEM RESIDENCE 
VOLUME IS OUTPUT 
VOLUME 


The output mass storage vol- 
ume is the volume from which 
the system has been loaded. 

G = refeed from the 
first volume 
statement. 

A = accept the 
situation. 

E = exit to the 
Supervisor. 

INSUFFICIENT 

MEMORY 


Insufficient memory is avail- 
able. Type 155, 258, 259 and 
273 Disk Pack Drives require 
16,384 characters of main 
memory. Type 261 and 262 
Disk Files require 20,480 
characters of main memory. 

E = exit to the 
Supervisor. 

FILE CANNOT BE 
PROCESSED 

1 

File name not found on the input 
mass storage or tape volume. 

G = mount the 

correct volume 
and retry. 

A = go to the next 
file. 

E = exit to the 
Supervisor. 

2 

File name not found on output 
mass storage volume. 

3 

Conflicting units of allocation 
or file descriptions. 

4 

File requested to be copied 
begins on a previous reel 
(reel mounted out of se- 
quence). 

5 

File being copied does not 
continue on the current reel 
(reel mounted out of se- 
quence). 

6 

A discrepancy exists in the 
file description index of the 
output mass storage volume 
directory during a tape-to- 
disk copy run. The condition 
has developed while an attempt 
is being made to copy all files 
from the input tape (the tape 
was created by the copy- 
named-files method and nei- 
ther FROM and TO parameters 
nor File statements were 
specified in the job control 
file for the current run). 

G = mount correct 
volume and 
retry. 

E = exit to the 
Supervisor. 
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Table 6-13 (cont). Messages Specific to Disk/Tape Copy C 


Typewriter Message 

Specific Code 
(alphanumeric ) 

Condition 

Operator Action* 

FILE CANNOT BE 
PROCESSED (cont) 

7 

Error in the volume directory. 

G = mount correct 

volume and retry. 

A = go on to the next 
file. 

E = exit to the 
Supervisor. 


No files can be processed. 
(None of the files designated 
in File statements has been 
found on both the input and 
output volumes. ) 

G = mount correct 

volume and retry. 

E = exit to the 
Supervisor. 

RECTANGLE CAN- 
NOT BE PROCESSED 

1 

This rectangle cannot be 
processed. 

G = mount correct 

volume and retry. 

A = go to the next 
rectangle. 

E = exit to the 
Supervisor. 

4 

Rectangle requested to be 
copied begins on a previous 
reel (reel mounted out of 
sequence). 

5 

Rectangle being copied does 
not continue on the current 
reel (reel mounted out of 
sequence). 


No rectangles can be pro- 
cessed. (All of the rectangles 
designated in FROM and TO 
parameters include tracks 
outside the rectangles extant 
on the input tape volume. ) 

G = mount correct 

volume and retry. 

E = exit to the 
Supervisor. 


The operator types the appropriate alphabetic response character and presses the space 
bar. 
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VOLUME MODIFICATION D 


Volume Modification D is a utility routine of the Mod 1 (MSR) Operating System. The 
routine assigns or establishes a substitute track for every user -specified bad track on a mass 
storage volume. A substitute track is assigned to a bad track that is not part of a file on the 
mass storage volume. A substitute track is established for a bad track that is part of a file on 
the mass storage volume. * 

If the * BADTRACKS and *VOLSPARES files have not already been created on the volume, 
they must be created by Volume Modification D before any processing of bad tracks can occur. 

Just before the end-of-run, the printer lists (1) the address of each bad track recorded in 
the *BADTRACKS file and (2) the addresses of all substitute tracks. 


EQUIPMENT REQUIREMENTS FOR VOLUME MODIFICATION D 


Basic Equipment Requirements 

The following basic equipment is required: 

A Series 200 central processor; 

Advanced Programming Instructions; 

16, 384 characters of main memory; 

One disk device and associated control unit. 

This combination may be any one of the following. 


Device Type 

Control Type 

155 

157C, 257C 

258 

257, 257-1, 260 

259 

257, 257-1, 260 

273 

257, 257-1, 260 

25 9A 

257A 

259B 

257B 

261 

260 

262 

260 


Also required are one card reader and one printer. 


*The following actions occur when a substitute track is assigned to, or established for, a bad 
track: 

Assign = A substitute track is assigned to the bad track from the #VOLSPARES file and an 
appropriate entry is made in the ^BADTRACKS file. 

Establish = The action is the same as that for "assign" plus (1) the substitute track is for- 
matted and (2) the data on the bad track is copied to the substitute track. Each 
defective data record on the bad track is listed on the printer. 
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Additional Usable Equipment 

One Type 220-1, -3 Console. 


FUNCTIONAL DESCRIPTION OF VOLUME MODIFICATION D 

Volume Modification D can perform the following functions: 

1. Creates the *BADTRACKS and *VOLSPARES files (an option); 

2. Checks the surface of all tracks in the *BADTRACKS and *VOLSPARES 
files (if these files are being created by the current run of Volume 
Modification D); 

3. Assigns or establishes a substitute track for every bad track specified 
in a Track statement; 

4. Performs the following actions if the substitute track is established for 
a bad track that is part of a file: 

a. Formats the substitute track with the number of records 
per track and the number of characters per record pre- 
scribed for the file, 

b. Transfers all records from the bad track to the substitute 
track, 

c. Prints out (on the printer) the defective record(s) on the bad 
track, and 

d. Formats the bad track with at least one bad -track track-linking 
record (TLR) pointing to the substitute track; 

5. Makes entries in the volume directory (if the bad track is in a file) and in 
the *BADTRACKS file (in all cases) to reflect every use of a substitute 
track as a replacement for a bad track; and 

6. Prints out (on the printer) the address of each bad track recorded in 
the *BADTRACKS file and the addresses of all substitute tracks. 

*BADTRACKS and *VOLSPARES Files 

The *BADTRACKS and *V OLSPARES files must be created on the volume when Volume 
Modification D is run if they have not been previously created by Volume Preparation C or an 
earlier run of Volume Modification D. The *BADTRACKS and *VOLSPARES files are created 
by Volume Modification D when the user includes the spares parameter (with an appropriate 
value) in the job control file. 


The *BADTRACKS file contains a permanent list of all substitute tracks and all known bad 
tracks on the volume. Each item in the *BADTRACKS file contains fields for the following 
information: 

1. The address of the bad track, 

2. The address of the track substituted for the bad track, 

^The spares parameter is described in detail in "Job Control Language for Volume Modification 
D, " later in this section. 
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3. The file name (if any) of the file that contains the bad track, 

4. Status information about the bad track, and 

5. The availability status of the substitute track. 1 

The *VOLSPARES file contains the spare tracks to be used as substitutes for bad tracks. 
Both the *BADTRACKS file and the * V OLSPARES file are described in the volume directory. 


Contingencies for Bad Tracks in Critical Areas 

Bad tracks in critical areas of a volume are treated as shown below: 

1. If a track within the *BADTRACKS file is bad, a halt or console message 
occurs. 2 It is not possible to continue the current run of Volume Modification C. 
The routine must be run again with the RELOCATE option specified in the spares 
parameter. 

2. If any track within the *VOLSPARES file is bad, no halt or console message 
occurs. The address of the bad substitute track is listed on the printer and 
that track becomes unavailable for use as a substitute. 

Conditions That Prevent Track Substitution 


FILE-RELATED CONDITIONS 

Under certain conditions, track substitution is not possible when a bad track occurs within 
a file that is already allocated to the volume. The conditions that prevent the use of substitute 
tracks are summarized below. 

1. All file organizations - Track substitution is not possible for bad 
tracks within a file that does not contain an integral number of 
blocks per track. 

2. Indexed sequential files - Track substitution is not possible in the 
following situations. 

a. If the bad track is the last track in the data portion 
of a cylinder. 

b. If the bad track is the last track in a cylinder overflow area. 

c. If the bad track is the last track in the general overflow area. 

A halt or console message occurs when track substitution is requested under any of the conditions 
above. The file containing the bad track(s) must be reallocated (see the File Support C section 
of the Mod 1 (MSR) Data Management Subsystem manual). 


The substitute track is "available" before it is substituted for a bad track. Thereafter, it is 
"unavailable. " 

2 

Control panel halts and console messages are described in "Operating Procedures for Volume 
Modification C, " later in this section. 
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OTHER CONDITIONS 

Track substitution is not possible for a track that is unusable. "Unusable" means that 
the track's surface is bad and not even one bad-track TLR can be read. It is very unlikely that 
any track will ever be unusable. * 

Formatting Substitute Tracks 

BAD TRACKS WITHIN AN ALLOCATED FILE 

If a bad track lies within a file (e. g. , "File A" ) that is already allocated to the volume, 
Volume Modification D formats the substitute track with the number of records per track and the 
number of characters per record prescribed for "File A. " The flag character in the header area 
of each record on the substitute track is set to reflect the file protection assigned to "File A. " 

The bad track's data is transferred, one record at a time, to the newly formatted substi- 
tute track. When a defective record is encountered, its data area is written out on the printer 
(for the user's information) as well as on the substitute track. 

(The volume directory and the *BADTRACKS file are appropriately updated to reflect the 
establishment of the substitute track. ) 

BAD TRACKS NOT WITHIN AN ALLOCATED FILE 

If a bad track does not lie within an allocated file, the substitute track is not formatted by 
V olume Modification D. 

(The *BADTRACKS file is updated to reflect the assignment of the substitute track. ) 
Linking Substitute Tracks 

When a substitute track is established for a bad track in an allocated file, the track-linking 
record (TLR) on the bad track (pointing to the next track in the file) is written onto the substitute 
track (causing the substitute track to point to the next track in the file). After the data on the 
bad track is written onto the substitute track, a bad-track TLR is written onto the bad track, 
linking it to the substitute track. 

The following diagram shows the resulting track linkage. 

^If the bootstrap track (cylinder 000, track 000) is unusable, a halt or console message occurs. 
The volume cannot be used as a system disk because it cannot be bootstrapped; however, the 
volume can be used for the storage of data. If the volume label track or any track within the 
volume directory is unusable, a halt or console message occurs. The volume cannot be used 
for any purpose. 
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TRACKS IN A FILE 



I l R | 

L 


If a substitute track (e. g. , Sub 1) subsequently becomes bad and a second substitute (e.g. , 
Sub 2) is established for it, the TLR linking Sub 1 to the next track is written onto Sub 2 (causing 
Sub 2 to point to the next track). After the data on Sub 1 is written onto Sub 2, a bad-track TLR 
is written onto the original bad track linking it to Sub 2 (thus. Sub 1 is subsequently bypassed 
altogether). 

The resulting track linkage is shown below. 


TRACKS IN A FILE 



I I R I 
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Uses of Volume Modification D 

The following examples illustrate how Volume Modification D can be run to accomplish 
four different objectives. In each case, job control language for the routine is shown as it is 
coded on an Easycoder coding form. Detailed information about job control statements and their 
parameter values is provided in "Job Control Language for Volume Modification D, " later in 
this section. 


EXAMPLE 1 - CREATING *BADTRACKS AND *VOLSPARES FILES 

EASYCODER 

COOING FORM 


PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

ii 

i 

LOCATION 

OPERATION 

CODE 

OPERANDS 


no non 

□ 

□ 


15 1 20 

2I . ... i ... . i . ... i . ... .... i g 

63. , i 80 

WH 

l 

1 


lif.W 

mm mmmmmmmmmmmmmmmm 

i'^HHHHPHHK^II 

Hi 






ppppppppp 

HI 

l 

l 





HU 


1 

. . -i . . . 

i . . i i 

cUSDESSEX^R^HHHHHHIIIHIIHIHlHi 


i r 
.i.i 

1 

H 

pm . 

VH' 


iphphhphmni 

| i 





.... i .... i .... i .... i ... . i . ... i .... i .... i. 

. . 1 .... 1 .... 1 ... . 

. L L 



. . i . . . 

-i . . . . 

i .... i ..... i .... i_. ... i . . ■ i .i-i i . . 



In Example 1, Volume Modification D is run for the sole purpose of creating the *BAD- 
TRACKS and *VOLSPARES files in a standard area of a volume named SCOTTY, whose serial 
number is A12345. The volume name and serial number are to be checked before the two new 
files are created on the volume. (It is assumed that the *BADTRACKS and *VOLSPARES files 
have not been previously created on this volume by Volume Preparation C or an earlier run of 
Volume Modification D. ) 

EXAMPLE 2 - CREATING *BADT RACKS AND *VOLSPARES FILES, ASSIGNING 
SUBSTITUTES FOR BAD TRACKS 

EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE PAGE OF 


CARD 

NUMBER 

fi 

1 

LOCATION 

OPERATION 

CODE 

OPERANDS 


DUUUO 

□ 

□ 

□HIHRI 

15, 20 

2I . ■ . ■ l . ■ ■ ■ 1 . ■ . ■ -L . ■ ■ . 1-. . ■ . .1— ■ ■ . ■ -i- . . ■ ■ i ■ ■ ■ • l 

63. . i , , . .80 

IT 

1 

1 


SCHH 


■MHMPPPI 

Tt 




i BHiiuy 


mmm mhh 

.i.i 






ppppppppp 

! i 




B3WS 1 



m 





1(^7. 4, . 


AH 







TT 






i ...... , 







, 

m 












. . . . J .... J .... 1 .... 1 .... 1 .... 1 .... 1, ... 1 . 


HI 





.... 1 .... 1 .... 1 .... 1 .... 1 .... 1 .... 1 .... 1 1 

, , 

HI 
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In Example 2, Volume Modification D is run to create the *BADTRACKS and *VOLSPARES 
files in a standard area of a volume named NELSON. The volume's name is to be checked but 
its serial number, if any, is not to be checked. After the two files have been created, a substi- 
tute track is assigned or established for the bad track specified in each of the three Track state- 
ments. (Any number of Track statements is permissible. ) 


EXAMPLE 3 - ASSIGNING SUBSTITUTES FOR BAD TRACKS (* BADTRACKS AND 
* VOLSPARES FILES PREVIOUSLY CREATED) 

EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE FAGE OF 


CARO 

NUMBER 


f 

fi 

LOCATION 

OPERATION 

CODE 

OPERANDS 


naans 

□ 

□ 

8. , . .14 

15 1 . . 20 



HH 


1 


;EX . . . 

LiSMISJ AW 

hhhdhhhh 



1 



Iname-, nelson.. 


LTjj 


1 


iiflWl 

IHMR HH HDHDHHHHHHHI 


HD 


r= 




.. 1 ... 1 1 .... 1 ... . 

HI 


i 







i 





SB 



1 ■ . . 

. I ■ ■ - 


. L- ... ■ ,.L. ■ 1 ■ . > ■ 1 . — L— .. . 


In Example 3, Volume Modification D is run to assign or establish a substitute track for 
a bad track where address is cylinder 54, track 2. The bad track at that address has been 
discovered on the volume named NELSON at some time after Volume Modification D was run 
in Example 2. The *BADTRACKS and *VOLSPARES files were created in Example 2, so no 
parameter is needed'to create them at this time. (Volume Modification D could also be run as 
shown in Example 3 if the ^BADTRACKS and *VOLSPARES files had been previously created on 
the volume by Volume Preparation C. ) 


EXAMPLE 4 - LISTING BAD TRACKS RECORDED IN THE * BADTRACKS FILE 


EASYCODER 

COOING FORM 

PROBLEM PROGRAMMER DATF FAGE OF 


CARO 

NUMBER 

6 

f 

B 

LOCATION 

OPERATION 

CODE 

OPERANDS 


uutitia 

0 

□ 

3HHHHHTC 

5j . , .20 




1 



HFH1! 

R 


r j 

1 




i 


HI 





HH HHH HH HH HHHIH HH 

.1 ... 1 1 


1 






HHfl 



■ ■ • ■ ■ 

» ■ • • ■ 

1.1 1 1 . . 1 1 1 1 L_. , J 1 1 .. . 1 L—l—i 1 1,1 . 1 1 L_l 1 1 

. , 1 . . 1 . 1 . . . . 1 . . . . 


In Example 4, Volume Modification D is run solely for the purpose of listing on the printer 
(1) the address of each bad track recorded in the *BADTRACKS file of a volume named MILNER 

and (2) the address of all substitute tracks on the volume. 
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The name of the volume is to be checked. The *BADTRACKS and *VOLSPARES files must 
have been previously created on MILNER either by Volume Preparation C or an earlier run of 
Volume Modification D. 

Every run of Volume Modification D automatically produces a printer listing as described 
above. In this example it can be assumed that no newly discovered bad tracks exist since no 
Track statements are included. 

JOB CONTROL LANGUAGE FOR VOLUME MODIFICATION D 

To run Volume Modification D, a job control file, consisting of a series of job control 
statements, must be placed in the card reader. Each job control statement contains one or more 
parameters. Some job control statements are required for every run of Volume Modification D; 
others are optional. 

In the following description of job control statements, the term "line" is the equivalent 
of one card in the job control file. 


Sequence of Job Control Statements 

Job control statements for Volume Modification D must appear in the following order: 

1. Execute statement (if the routine is loaded from mass storage); 

2. Volume statement; 

3. File statement (if present); and 

4. Track statement(s) (if present). 

The last line of the last job control statement must contain an E in its mark field or be followed im- 
mediately by a line with blanks in its operation code and operands fields and an E in its mark field. 


Figure 7-1 contains a complete set of job control statements (some of which are optional) 
for Volume Modification D. 

EASYCODER 

CODING FORM 


PROBLEM PROGRAMMER DATE RAGE OF 


CARD 

NUMBER 

n 

if 

I 

LOCATION 

OPERATION 

CODE 

OPERANDS 


no non 

□i 

Jammu 

15, 20 



IT 



EL. 


HHmmmiiiH 





NAME*. Vo 1 ume- name., . . . 

T&jnutreA . , . . . 

MN 




spares ves . . y . . 

rr 

MB 




, ^ no. . L ,...., 






...... I .RELOCATE 1. . . 

L1HM 







Ml 




SERI A, L' .Ss.*, *.*.« , 

Optional . i .... i ... . 

MM 




DEVAl>i?.~ f.frAiu.. drl wa). . . . . 

Optional 

i i 



file 






r,2.A<Lk 

CCt^ r.+ r ^ . i .... i .... i .... i .... i .... i ... i . 

■RaA, 4rai>.L .... 

-H — r 

.i.i 


...... 



i . . . 

1 1 







Figure 7-1. Job Control Statements for Volume Modification D 
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Execute Statement 

The Execute statement is used only when Volume Modification D is loaded from mass 
storage. The Execute statement directs the Supervisor to load the Volume Modification D 
routine from the system disk. An Execute statement is required for every run of this routine 
when it is mass storage resident. 

The Execute statement is not used when Volume Modification D is loaded from magnetic 
tape. (For a description of loading from magnetic tape, see "Operating Procedures for Volume 
Modification D, " later in this section. ) 

Volume Statement 

The Volume statement is always used to identify the name of the volume to be processed. 

The Volume statement also indicates the address (either user-specified or defaulted) of the disk 
device on which the named volume is mounted. In addition, the Volume statement can be used, 
at the user's option, to create the *BADTRACKS and *VOLSPARES files on the volume in either 
a standard area or a user- specified area. The parameters of the Volume statement are as 
follows: 

VOLUME -NAME PARAMETER 

The volume-name parameter (NAME) identifies the volume to be processed. This parameter 
is required for every run of Volume Modification D to insure that the correct volume is present. 

If an incorrect volume has been mounted, a halt or console message occurs. The form of this 
parameter is shown below. 

| NAME = volume -name, 


volume - name = This name may be up to six characters in length. If fewer than 
six characters are specified, this field on the volume label is 
zero-filled to the left. 

SPARES PARAMETER 

The spares parameter can be used, at the user's option, to create the *BADTRACKS and 
* V OLSPARES files on the mass storage volume. If a *BADTRACKS file and a *V OLSPARES file 
have not been created on the volume by Volume Preparation C, they must be created by Volume 
Modification D before any processing can occur. 

Unless the RELOCATE option is specified, the two files are created in a standard area on 
the volume. The RELOCATE option allows the user to locate the files in an area of his choice 
(with certain limitations, explained under "FROM and TO Parameters"). 
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The form of this parameter is shown below: 



YES ] 


SPARES = 

NO ; 

RELOCATE 

' * 


YES = A *BADTRACKS file and a *VOLSPARES file are to be created. 

The two files will occupy all of the tracks in the following standard areas. 


I 


NO * The *BADTRACKS and *VOLSPARES files are not to be created. 

RELOCATE = A *BADTRACKS file and a *VOLSPARES file are to be created 
in an area specified by the user. This option may be used if 
these files cannot be created in the standard area. The RE- 
LOCATE option must be followed immediately by a pair of FROM 
and TO parameters. 

Default assumption: NO 
FROM AND TO PARAMETERS 

A pair of FROM and TO parameters is used only when the RELOCATE option has been 
specified in the spares parameter. The pair of FROM and TO parameters enables the user 
to designate the area on the volume where the *BADTRACKS and *VOLSPARES files are to be 
created. The pair of FROM and TO parameters must immediately follow the spares parameter 
in the job control file. 


Device Type 

Cylinders 

155 

200 - 202 

258 

101 - 103 

259, 273, 259A, 259B 

200 - 202 

261, 262 

125 - 127 


The form of this parameter is shown below. 

FROM = (ccc, ttt), TO = ccc, ttt), 

ccc = The cylinder address, in decimal, where leading zeros are not 
required. The first cylinder on the volume is numbered zero. 

ttt = The track address, in decimal, where leading zeros are not 

required. The first track on each cylinder is numbered zero. 

The pair of FROM and TO parameters specifies that the *BADTRACKS and *VOLSPARES 
files are to occupy the following area of the mass storage volume: all the tracks from the track 
stated in the FROM parameter to the track stated in the TO parameter (inclusive) on each cylinder 
from the cylinder stated in the FROM parameter to the cylinder stated in the TO parameter 
(inclusive). 
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The area designated by a pair of FROM and TO parameters can be as large as the user 
desires or as small as two tracks (one track for the *BADTRACKS file and one for the 
*VOLSPARES file). This user-designated area can be located anywhere on the volume except 
where it would conflict with the bootstrap track, substitute bootstrap track, volume label, 
volume directory, or an existing file. 

VOLUME-SERIAL-NUMBER PARAMETER 

This parameter is used to check the volume serial number (if any) written onto the volume 
label by Volume Preparation C. This parameter is used to insure that the correct volume is 
present. If an incorrect volume has been mounted, a halt or console message occurs. Use of 
this parameter is optional. The form of this parameter is shown below. 

| SERIAL = volume-serial-number," 

volume -serial -number = This value may be up to six alphanumeric characters in 

length. If fewer than six characters are specified, this 
field on the volume label is zero-filled to the left. 

Default assumption: the volume serial number is not checked. 

DEVICE -ADDRESS PARAMETER 

The device-address parameter (DEVADD) indicates the address of the disk device holding 
the volume to be processed. The form of this parameter is shown below. 

|^E^ADD=Jpcu^drive), 


pcu = The peripheral control unit address of the disk device on which the 
volume is mounted, written as two octal characters. The I/O bit 
is not used, but all other bits, including the sector bits, must be 
specified. 

drive = The drive number, written as one octal character. 

Default assumption: pcu 04, drive 0. 


File Statement for the List File 

During every run of Volume Modification D, the printer lists (1) the address of each bad 
track recorded in the *BADTRACKS file and (2) the addresses of all substitute tracks. This 
printer listing is called the list file. 


The File statement for the list file is required only when the printer is assigned to an 
address other than peripheral control unit 02. The format of this statement is shown in line 9 
of Figure 7-1 . 
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DEVICE -ADDRESS PARAMETER 

The device-address parameter (DEVADD) is used to indicate the peripheral control unit 
address of the printer. The form of this parameter is shown below. 

| DEVADD = (pcu~ 

pcu = The address of the printer's peripheral control unit. The address must be 
two octal characters. The I/O bit is not used, but all other bits, including 
sector bits, must be specified. 

Default assumption: 02 

Track Statement 

A Track statement is used to indicate the address of a bad track for which a substitute is 
to be made during the current run of Volume Modification D. The format of the Track statement 
is shown on line 10 of Figure 7-1. * 

A separate Track statement is required for each bad track. Any number of Track state- 
ments may be included, but they must follow all other job control statements of Volume Modifica- 
tion D. 

Use of Track statements during the routine requires that the *BADTRACKS and 
*VOLSPARES files exist on the volume. (The two files may have been created previously or 
they may be created by the current run of the routine. ) 


OPERATING PROCEDURES FOR VOLUME MODIFICATION D 

Loading Volume Modification D 

Volume Modification D can be loaded in two ways: 

1. From mass storage, by means of the Supervisor, under the 
Mod 1 (MSR) Operating System; 

2. From magnetic tape, by means of Floating Tape Loader -Monitor C, 
under the Mod 1 (TR) Operating System. 

MASS STORAGE RESIDENT 

When the routine is loaded from mass storage, an Execute statement (as illustrated in 
Figure 7-1) must be submitted in the job control file, followed by the desired job control state- 
ments for the routine. 


^The address of the bad track is written in the decimal format ccc, ttt, where ccc is the cylinder 
address and ttt is the track address. Leading zeros are not required. 
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TAPE RESIDENT 

Loading the routine from magnetic tape is the same as loading from mass storage except 
that a console call card is used instead of an Execute statement. The format of the console 
call card is shown below. 


Table 7-1. Console Call Card Format 


Characters 

Contents 

Meaning 

1 - 8 

*VOLUMOD 

Program and segment names of 
Volume Modification D. 

9 

d 

Tape drive number from which 
Volume Modification D is to be 
loaded. 

18 

* 

Asterisk (required by the Mod 1 
(TR) Operating System). 


Protection Switch Settings 

Before running Volume Modification D, the user must set to PERMIT all protection 
switches on the peripheral control unit of the disk device holding the volume to be modified. 

Operator Communication and Control 

When an error condition occurs, 2 -way communication between the operating system and 
the operator is achieved through a control panel or (if certain software and hardware require- 
ments have been met) through a console. If the communication medium is a control panel, an 
error condition causes the central processor to halt. If the communication medium is a console, 
an error condition causes a typewriter message to appear, but the central processor does not 
halt. 


Halts or console messages are caused by three types of error conditions: peripheral 
device conditions, job control file conditions, and conditions specific to Volume Modification D; 
When a halt or console message occurs, the operator must determine which error condition 
exists and then make the appropriate response. 

CONTROL PANEL HALTS 

At the time of a control panel halt, the B-address register contains a value that identifies 
the error condition. In most cases, the A-address register contains the address of a response 
location in main memory. The response location is a 1 -character main memory location into 
which the operator must enter a response character appropriate to the error involved. Where 
indicated, additional information concerning the error can be found in the main memory loca- 
tions immediately following the response location. This additional information is called the 
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supplementary List (see Table 7-2) and is composed of the following elements (arranged in 
ascending order of contiguous main memory locations). 


Table 7-2. Supplementary List 


Field Name 

Length 

Specific code 

One character (A+l) 

Volume name 

Six characters 

Volume serial number 

Six characters 

Mass storage pcu address 

One character 

Device address 

One character 

Magazine number 

One character 

Error address* 

Six characters in the decimal format cccttt 

File name (if applicable) 

Ten characters 

^Significant only for certain mass 
(otherwise blank). 

storage peripheral device errors 


Peripheral Device Halts 

AB-address register value in the range from 0000 to 3777 indicates an error condition 
involving a peripheral device. The operator should consult Table 7-3. The B-address register 
value has the general form ppxd, where: 

pp = Peripheral control unit (leftmost bit set to zero); 
x = Code indicating type of error condition: 

0 = Device not operable, 

1 = Uncorrectable read error, 

2 = Uncorrectable write error, 

4 = Positioning error, and 

7 = Miscellaneous error; 
d = Device number. 

These values are consistent with the standard peripheral error halt codes. 

In all cases except the card read error, the A-address register contains the address of 
a response location. The supplementary list is also present (see Table 7-2). 
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Table 7-3. Peripheral Device Halts 


B -Address 

Register 

Contents 

Specific 

Code 

Condition 

Operator Action* 

ppOd 

01 

02 

Device inoperable. 
Protection violation. 

G = retry. 

E = exit to the Supervisor. 

ppld 

07 

Read error (mass 
storage). 

G = retry. 

E = exit to the Supervisor. 


Read error (cards). 

Correct erroneous card, refeed start- 
ing with that card, and press RUN. 

pp2d 

04 

12 

Format violation. 
Track overflow. 

G = retry. 

E = exit to the Supervisor. 

10 

Write error. ^ 

G = retry. 

S = skip defective track and resume 
processing. 

E = exit to the Supervisor. 

pp4d 

03 

Positioning error. 

G = retry. 

E = exit to the Supervisor. 

13 

Positioning error. 

E = exit to the Supervisor. 

pp7d 

11 

Miscellaneous device 
error condition - 
possible device 
failure. 

G = retry. 

E = exit to the Supervisor. 

*The operator enters the appropriate response character and presses RUN. 

G = 27g, S = 62 g , E = 25 g . 

2 

An unusable track has been encountered on the volume. The printer produces the 
following message: CYL ccc TR ttt UNUSABLE (ccc and ttt are decimal numbers). 
"Unusable" means that the track surface is bad and not even one bad-track track- 
linking record can be read. It is very unlikely that any track will ever be unusable. 


Job Control File Halts 

A B-address register value in the range from 5000 to 5077 signifies an error condition 
involving the job control file. The operator should consult Table 7-4. The A-address register 


contains the address of the response location. The supplementary list is not produced. 

Table 7-4. Job Control File Halts 


B-Address 

Register 

Contents 

Condition 

Operator Action* 

— — 

5001 

Invalid command field. 

G = attempt to perform the opera- 
tion again. The operator cor- 
rects the erroneous job control 
statement: refeeds the cards. 

5002 

Invalid positional parameter. 

5003 

Invalid keyword. 
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SECTION VII. VOLUME MODIFICATION D 


TabLe 7-4 (cont). Job Control File Halts 


B -Address 

Register 

Contents 

Condition 

Operator Action* 

5004 

Required parameter missing. 

starting with the Volume state- 
ment; enters a G; and presses 
RUN. The program then re- 
processes the job control file. 

E = exit to the Supervisor. 

5005 

Invalid keyword parameter 
value . 

5010 

Invalid combination or sequence 
of parameters. 

'° " 2 V E = 2 V 


Halts Specific to Volume Modification D 

A B-address register value in the range from 6550 through 6567 indicates a halt specific 
to Volume Modification D. The operator should consult Table 7-5. 


The A-address register contains the address of the response location. The supplementary 
list is also present (see Table 7-2). 


Table 7-5. Halts Specific to Volume Modification D 


B-Address 

Register 

Contents 

Specific 

Code 

Condition 

Operator Action* 

6550 

01 

02 

Wrong volume mounted: 

Volume-name check 
failed. 

Volume- serial-number 
check failed. 

G = reread the volume label. 
E = exit to the Supervisor. 

6551 


An attempt is being made 
to process a Track state- 
ment, but the 
*BADTRACKS and 
* VOLSPARES files have 
not been created on the 
volume. 

E = exit to the Supervisor. 

6552 


Either of two conditions 
exists: 

1. There are no more 
available substitutes 
in the *VOLSPARES 
file. Further track 
substitution is pos- 
sible only for a Track 
statement containing 

S = skip the current Track 

statement and continue to 
the next Track statement, 
if any. 

E = exit to the Supervisor. 
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Table 7-5 (cont). Halts Specific to Volume Modification D 


B-Address 

Register 

Contents 

Specific 

Code 

Condition 

Operator Action* 

6552 

(cont) 


the address of the boot- 
strap track or the sub- 
stitute bootstrap track. 

2. There is no substitute 
bootstrap track avail- 
able. (The volume 
cannot be used as a 
system disk. ) 


6553 

01 

A bad track exists in a 
file that does not meet 
the requirements for 
the use of substitute 
tracks. 

S = skip the current Track 
statement and continue 
to the next Track state- 
ment, if any. 

E = exit to the Supervisor. 


02 

A substitute track, 
currently established 
for a bad track in a 
partitioned sequential 
file, has been declared 
bad in a Track statement. 

A = establish a new substitute 
track and continue 
processing. 

S and E are the same as 
for 01. 

6554 


A bad track exists in the 
*BADTRACKS file. 
(Volume Modification D 
must be run again with 
the RELOCATE option. ) 

E = exit to the Supervisor. 

6555 


There is an unusable 
track in the volume label 
or the volume directory. 
(The volume cannot be used.) 

E = exit to the Supervisor. 

6556 


The bootstrap track (cyl- 
inder 000, track 000) is 
unusable. ^ (The volume 
cannot be used as a system 
disk; i. e. , it cannot be 
bootstrapped. ) 

A = accept the condition 

and continue processing 
the volume. 

E = exit to the Supervisor. 

6557 

01 

02 

Duplication error: 

An attempt is being made 
to create the *BADTRACKS 
and *V OLSPARES files and 
these files already exist 
on the volume. 

The unit of allocation (either 
specified or defaulted) for 
the *BADTRACKS and 
* VOLSPARES 

E = exit to the Supervisor. 
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SECTION VII. VOLUME MODIFICATION D 


Table 7-5 (cont). Halts Specific to Volume Modification D 


B -Address 

Register 

Contents 

Specific 

Code 

Condition 

Operator Action* 

6557 

(cont) 


files conflicts with that 
of a file already existing 
on the volume. 



03 

A substitute has already 
been assigned for the 
bad track named in the 
current Track statement. 

S = skip the current 
Track statement 
and continue to the 
next Track statement, 
if any. 

E = exit to the Supervisor. 

6567 


There is insufficient 
memory for the buffer 
required by the current 
Track statement. 

S = skip the current Track 
statement and continue 
to the next Track, state- 
ment, if any. 

E = exit to the Supervisor. 


*The operator enters the appropriate response character and presses RUN 
(G = 27g, S - 62g, A = 21g, E — 25g). 

^"Unusable" means that the track surface is bad and not even one bad-track TLR can be read 
from the track. It is very unlikely that any track will ever be unusable. 


CONSOLE MESSAGES 

The console can be used for operator control when the Supervisor (in the Mod 1 (MSR) 
Operating System) or Floating Tape Loader -Monitor C (in the Mod 1 (TR) Operating System) 
has been appropriately specialized. 


When the console is used for operator control, an error condition does not cause the 
system to halt. Instead, a diagnostic message is typed out on the console. The operator takes 
the following steps. 

1. He reads the typeout. (To repeat the message, he presses the space bar 
twice.) If necessary, he consults the manual for possible action. 

2. He performs the desired corrective action. 

3. He types the appropriate 1-character response (G, E, etc. ). 

4. If the typein is correct, he presses the space bar to continue. 

If it is incorrect, he types any nonspace character and returns 
to step 3. 

The routine continues as directed by the response code. If an invalid response is made, the 
routine causes the diagnostic message to reappear. 

The following paragraphs provide detailed information about the three kinds of console 
messages. 
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Peripheral Device Messages 

Console messages specific to peripheral device error conditions are listed in Table 7-6. 
The format of these messages is: 
pp d MESSAGE TEXT 

where pp = Peripheral control unit (leftmost bit set to zero), 
d = Device number, and 
MESSAGE TEXT specifies the error condition. 

A second line of typed information contains the supplementary list described in Table 7-2. 


Table 7-6. Peripheral Device Messages 


Typewriter Message 

Specific 
Code (alpha- 
numeric) 

Condition 

Operator Action"^ 

pp d INOPERABLE 

1 

2 

Device inoperable. 
Protection violation. 

G = retry. 

E = exit to the Supervisor. 

pp d READ ERROR 

7 

Read error 
(mass storage). 

G = retry. 

E = exit to the Supervisor. 


Read error 
(cards). 

Correct erroneous card, 
refeed starting with that 
card, and press space bar. 

pp d WRITE ERROR 

4 

i 

Format violation. 
Track overflow. 

G = retry. 

E = exit to the Supervisor. 

8 

Write error. ^ 

G = retry. 

S = skip defective track 

and resume processing. 

E = exit to the Supervisor. 

pp d POSITIONING 
ERROR 

3 

Positioning error. 

G = retry. 

E = exit to the Supervisor. 


= 

Positioning error. 

E = exit to the Supervisor. 

pp d MISCELLANEOUS 

9 

Miscellaneous device 
error condition - 
possible device 
failure. 

G = retry. 

E = exit to the Supervisor. 


The operator types the appropriate alphabetic response character and presses the 
space bar. 

An unusable track has been encountered on the volume. The printer produces the following 
message: CYL ccc TR ttt UNUSABLE (ccc and ttt are decimal numbers). "Unusable" 
means that the track surface is bad and not even one bad-track track -linking record can be 
read. It is very unlikely that any track will ever be unusable. 
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SECTION VII. VOLUME MODIFICATION D 


Job Control File Messages 

All messages involving errors in the job control file begin with the words JOB CONTROL 
FILE ERROR. Table 7-7 contains the complete texts of all job control file messages for Volume 
Modification D. The supplementary list is not produced. 


Table 7-7. Job Control File Messages 


Typewriter Message 

Condition 

Operator Action * 

JOB CONTROL FILE ERROR, 
COMMAND FIELD 

Invalid command 
field. 

G = attempt to perform the 
operation again. The 
operator corrects the 
erroneous job control state- 
ment; refeeds the cards, 
starting with the Volume 
statement; enters a G; and 
presses the space bar. 

E = exit to the Supervisor. 

JOB CONTROL FILE ERROR, 
POSITIONAL PARAMETER 

Invalid positional 
parameter. 

JOB CONTROL FILE ERROR, 
KEYWORD PARAMETER 

Invalid keyword. 

JOB CONTROL FILE ERROR, 
MISSING PARAMETER 

Required parameter 
missing. 

JOB CONTROL FILE ERROR, 
PARAMETER VALUE 

Invalid keyword 
parameter value. 

JOB CONTROL FILE ERROR, 
PARAMETER COMBINATION 

Invalid combination 
or sequence of 
parameters . 

*The operator types the appropriate alphabetic response character and presses the space bar. 


Messages Specific to Volume Modification D 

Table 7-8 contains messages for error conditions specific to Volume Modification D. The 
typewriter messages in Table 7-8 are followed by a second line of typed information, which con- 
tains the supplementary list described in Table 7-2. 


Table 7-8. Messages Specific to Volume Modification D 


Typewriter Message 

Specific 

Code 

(alphanumeric ) 

Condition 

Operator Action*- 

INCORRECT VOLUME 


W rong volume 
mounted: 

G = reread the 

volume label. 


1 

Volume -name check 
failed. 

E = exit to the 
Supervisor. 


2 

Volume -serial- 
number check failed. 


* BADTRACKS NOT 
ON VOLUME 


An attempt is being 
made to process a 
Track statement, but 
the *B ADT RACKS and 
* V OLSP ARES files 
have not been created 
on the volume . 

E = exit to the 
Supervisor. 


<5 
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Table 7-8 (cont). Messages Specific to Volume Modification D 


Typewriter Message 

Specific 

Code 

(alphanumeric) 

Condition 

Operator Action* 

NO SUBSTITUTE 
TRACK AVAILABLE 


Either of two 
conditions exists: 

1. There are no more 
available substitutes 
in the *VOLSPARES 
file. Further track 
substitution is possi- 
ble only for a T rack 
statement containing 
the address of the boot- 
strap track or the sub- 
stitute bootstrap track. 

2. There is no sub- 
stitute bootstrap track 
available. (The 
volume cannot be used 
as a system disk. ) 

S = skip the current 
Track statement 
and continue to 
the next Track 
statement, if any. 

E = exit to the 
Supervisor. 

FILE CANNOT 
CONTAIN BAD 
TRACKS 

1 

A bad track exists 
in a file that does 
not meet the require- 
ments for the use of 
substitute tracks. 

S = skip the current 
Track statement 
and continue to 
the next Track 
statement, if 
any. 

E = exit to the 
Supervisor. 

2 

A substitute track, 
currently established 
for a bad track in a 
partitioned sequential 
file, has been de- 
clared bad in a Track 
statement. 

A = establish a new 
substitute track 
and continue 
processing. 

S and E are the 
same as for 1. 

BAD TRACK IN 
*BADT RACKS FILE 


A bad track exists 
in the *BADT RACKS 
file. (Volume Modi- 
fication D must be 
run again with the 
RELOCATE option.) 

E = exit to the 
Supervisor. 

UNUSABLE TRACK IN 
DIRECTORY OR LABEL 


There is an unusable^ 
track in the volume 
directory or the volume 
label. (The volume 
cannot be used. ) 

E = exit to the 
Supervisor. 
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Table 7-8 (cont). Messages Specific to Volume Modification D 


Typewriter Message 

Specific 

Code 

(alphanumeric) 

Condition 

Operator Action ^ 

UNUSABLE BOOT- 
STRAP TRACK 


The bootstrap track 
(cylinder 000, track 
000) is unusable. 2 

(The volume cannot be 
used as a system disk; 
i. e. , it cannot be 
bootstrapped. ) 

A = accept the 

condition and 
continue proces- 
sing the volume. 

E = exit to the 
Supervisor. 

DUPLICATION 

ERROR 


Duplication error: 

E = exit to the 
Supervisor. 


1 

An attempt is being 
made to create the 
*BADT RACKS and 
*VOLSPARES files 
and these files already 
exist on the volume. 



2 

The unit of allocation 
(either specified or 
defaulted) for the 
*BADT RACKS and 
*VOLSPARES files 
conflicts with that of a 
file already existing 
on the volume. 



3 

A substitute has 
already been as- 
signed for the bad 
track named in the 
current Track state- 
ment. 

S = skip the current 
Track statement 
and continue to 
the next Track 
statement, if 
any. 




E = exit to the 
Supervisor. 

INSUFFICIENT 
MEMORY FOR 
BUFFERS 


There is insufficient 
memory for the 
buffer required by 
the current Track 
statement. 

S = skip the current 
Track statement 
and continue to 
the next Track 
statement, if 
any. 




E = exit to the 
Supervisor. 


^The operator enters the appropriate alphabetic response character and presses the 
space bar. 


^"Unusable" means that the track surface is bad and not even one bad-track TLR can be 
read from the track. It is very unlikely that any track will ever be unusable. 
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APPENDIX A 

CALCULATION OF SORT-ITEM BLOCK SIZE 


Parameter 08 of the Fetch macro routine specifies the buffer size required for reading 
blocks from the sort-item file. If the value given to this parameter is less than that required, 
the Fetch cannot be executed. If, however, the assigned value of the parameter exceeds the re- 
quirement, some memory locations will be wasted, but the Fetch will be executed. Also, cal- 
culation of the sort- item block size is necessary for an accurate computation of the work area 
required to execute the sort. 

The calculation of the sort-item block size is based upon certain previous calculations, 
which are described below. Certain other information is derived as a result of these calculations 
such as the maximum sort-item size acceptable to the sort. 


CALCULATING HIGHEST MEMORY LOCATION AVAILABLE TO PRESORT 
No Presort Own-Coding Present 

Let HMPS = HMA, where HMA represents the highest memory address available to the 
sort. (Note that HMPS is not always equal to the value specified by the user for the highest 
memory location. ) 

Presort Own-Coding Present 

When own -coding is present, the highest memory address available to any logical segment 
of the sort (i.e. , presort or merge) may be determined from the base address of the own-code 
program that is resident during the execution of that logical segment. 

OWN-CODING OUTSIDE SORT AREA 

If all own-code values are greater than the highest memory address parameter or lie below 
the base of the sort, then let HMPS = HMA. (Note that own-coding can only lie below the base of 
the sort if the sort has been relocated from its present base value of 200 decimal. ) 

OWN-CODING WITHIN SORT AREA 

If there is no merge own-coding or the merge own-code program is to be called by the sort, 
the following applies. 

1. PSOPEN is defined as the value of the presort open exit. 

2 . PSITEM is defined as the value of the presort item exit. 

3. Let HMPS = PSOPEN-1, if PSOPEN is less than PSITEM; otherwise, let 
HMPS = PSITEM- 1. 
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When merge own-coding is loaded prior to the execution of the sort, then the following 
applies. 

1. MERGE is defined as the value of the merge own-code exit. 

2. HMPS is defined as the least of the three values PSOPEN-1, PSITEM-1, 
or MERGE- 1. 

CALCULATING HIGHEST MEMORY LOCATION AVAILABLE TO MERGE 

Merge own-code is active only during the merge multicylinder phase; and therefore, the 
merge 1 -cylinder phase is affected only if the merge own-code is resident at the beginning of 
sort execution. Calculation of HMMC is significant only in terms of the merge multicylinder 
phase. 

No Merge Own-Coding Present 

The formula HMMC = HMA applies. 

Merge Own-Coding Present 

OWN- CODING OUTSIDE SORT AREA 

If the merge own-coding value is greater than the highest memory address parameter or 
lies below the base of the sort, then the formula HMMC = HMA applies. 

OWN-CODING WITHIN SORT AREA 

The formula HMMC = (MERGE- 1) applies. 

CALCULATING SORT -ITEM SIZE 

The following variables are defined for calculating sort -item size: 

KL = Total number of key characters; 

EL = Total number of extract characters; 

AS = Zero, if no item address is appended; 11, if item address is appended; and 
SIS = KL + EL + AS. 

If an item sort is requested and IL represents the input item length, then the following 
formula applies. 

SIS = IL + AS 

In general, for an item sort, it is expected that AS = 0. 

CALCULATING SPACE AVAILABLE TO PRESORT 

For calculating the space available to presort, the following formula applies. 

PS = HMPS - PROG - SUP - TYPE, 
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where 


SUP 

TYPE 

PROG 

PROG 

PROG 

PROG 

PROG 


Supervisor memory requirement (see Supervisor manual); 

2150 if a typewriter is present, otherwise 0; 

7650 when sequential files are processed; 

8750 when direct access files are processed; 

8750 when indexed sequential files are processed; 

7650 when input to the sort is from 1 /2-inch magnetic tape; and 
6000 when input to the sort is through own-coding only or 
when input is from cards. 


CALCULATING SPACE AVAILABLE TO MERGE 

The following formula applies for calculating the space available to the merge: 

PM = HMMC - 5700 - SUP - 2(SIS) - TYPEM, 

where: TYPEM = 1500 if a typewriter is present, otherwise 0. 


Single and Double Buffering Mode 

Whether to use single or double buffering is decided at presort execution time. This 
decision is significant in determining the sort-item block size (see Tables A-l and A-2). If 
bad tracks are present in any of the volume areas used for the work files, use Tables B-4 and 
B-5 for all calculations involving the disk tables (see "Bad Track Handling Procedures for 
Mass Storage Sort C" in Appendix B). 


Table A-l. Disk Table (Type 155, 258, 259, 273, 259A 
and 259B Disk Pack Drives) 


Column A 

Column B 

Data 

Records 

Characters 

Per 

Per Block 

Block 

241 

1 

491 

2 

741 

3 

991 

4 

1, 241 

5 

1,491 

6 

2,491 

10 

3, 741 

15 

NOTE: Use Table B-4 if 

bad tracks are 

present 

in work 

file(s). 



1/5/70 


A-3 


#3-619 




APPENDIX A. CALCULATION OF SORT -ITEM BLOCK SIZE 


Table A-2. Disk Table (Type 261 and 262 Disk Files) 


Column A 

Column B 

Data 

Records 

Characters 

Per 

Per Block 

Block 

241 

1 

491 

2 

741 

3 

991 

4 

1, 241 

5 

1,491 

6 

2,491 

10 

3, 741 

15 

4, 991 

20 

7,491 

30 

NOTE: Use Table B-5 if bad tracks 

are present in work file(s). 


When the work files are on Types 155, 258, 259, 273, 259A, or 259B Disk Pack Drives, use 
Table A-l, but if the work files are on Type 261 or 262 Disk Files, use Table A-2 to find the 
least value in column A that is greater than or equal to the sort-item size (SIS). Let that value 
be represented by PBS (physical block size). 

1. Calculate NI, = f 1 

1 L SIS J 

where: NI^ = temporary value for the sort-item block factor (rounded down 
to the next lowest integer). 

2. Calculate IS 1 = 3 [ NIj (SIS + 12) ] 

where: IS^ = a temporary item storage factor. 

3. Calculate OS : = NI [ SIS ] 

where: OS^ = a temporary value for the block size. 

The presort will operate with double buffering if the two following conditions are met viz: 

1. PS> 2 (INB)+ ISj + 2(OSj) + 26, and 

2. PM> 3(05^ + 26. 


CALCULATING SORT-ITEM BLOCK SIZE FOR SINGLE BUFFER MODE 


To determine the sort-item block size for the single buffering mode, perform the 
following calculations: 


1 . 

2 . 


Calculate NI^ = 
Calculate NI^ = 


r PS - INB - 1 3 i 

L 2 (SIS + 6) J 

[ PM - 34 ] 

L SIS J 


(rounded down to the next lower integer), and 
(rounded down to the next lower integer). 
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NI is the least of the three values NI^, NI^, or NI^, where NI represents the sort-item blocking 
factor (NIi having been calculated in the previous paragraph). The sort-item block size for 
single buffering, then, is: 

OS = NI (SIS) + 9 

CALCULATING SORT-ITEM BLOCK SIZE FOR DOUBLE BUFFER MODE 

When the presort finds that double buffering is possible, it attempts to increase the sort- 
item block size, provided that a string of items can be maintained that holds at least three times 
the number of items that can be contained in a sort-item block. A further factor in the computa- 
tion is that there should be an efficient covering of the work-file area. 


To determine the sort-item block size for the double buffering mode, perform the following. 

1. Calculate PMD = PS - 2 (INB) - 26 

where: PMD = the space available to the presort after an allowance has been 
made for the two input buffers and output buffer control. 

2. Calculate ISB = 5 (SIS) + 36 
where: ISB = an item capacity unit. 

3. Calculate NI, = (rounded down to the next lowest integer) 

1 ISB 

4. Calculate OS 1 = N^ (SIS). 

5. Using Table A-l or Table A-2, find in column A the least value greater than 
or equal to OS^. Let that value be PBS^. If there is a member of Table A-l 
or Table A-2 less in value than PBS , represent it as PBS . This rule has 

h Li 

-two exceptions, as shown below. 

a. If PBS, = 241, go to step 8c, 

n 

b. If OSj is greater than 3, 741, calculate the following: 

NI =[ 3 ^|L] (rounded down to next lowest integer); go to step 9. 

6. Calculate the following: 

= PBS - NI. (SIS) 
h n 1 

where: W^=the number of characters of a group of physical records repre- 
sented by PBS^ that would not be occupied by a sort-item block. 

NIj is calculated in step 3. 

7. Calculate the following: 

a. NI^ = f j (rounded down to the next lowest integer) 

b. W T = PBS - NI- (SIS) 

Xj J -u c. 

where: W = the number of characters of the group of physical records 
that would not be occupied by the sort-item block. 
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8 . 



Calculate the following: 

a. I£W t < W T then NI = NI. ; 

h ~ L 1 

b. IfW L > W T then NI = NI,; and 

h Li l, 

c. When PBS.^ = 241, NI = j (rounded down to the next lowest integer) 

The sort-item block size = OS = NI (SIS) + 9. 
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BAD TRACK HANDLING PROCEDURES 


This appendix contains a general description of bad track handling procedures incorpo- 
rated in the Mod 1 (MSR) Operating System. Following the general description, there is informa- 
tion regarding bad track handling procedures applicable to three utility routines: Volume Prep- 
aration C, Mass Storage Sort C, and Disk/Tape Copy C. 

TRACK SUBSTITUTION CAPABILITY 

The Mod 1 (MSR) Operating System provides the user with the option of track substitution 
capability. Track substitution is designed to minimize inconvenience and possible data loss that 
might result from an uncorrectable read error caused by a defect on the magnetic surface of a 
mass storage volume. A track on which an uncorrectable read error occurs is defined as a "bad 
track. " 

In general, whenever a bad track is encountered by the system software, the operator is 
notified by a control panel halt or a console message. * A spare track can then be substituted for 
the bad track and file data (if any) transferred from the bad track to the substitute track; in addi- 
tion, when data is transferred, the contents and header area of any record for which a read error 
was detected are printed out, as accurately as possible, for the user's information. Once a 
spare track has been established as the substitute for a bad track, the system's logical and physi- 
cal I/O control can subsequently process the file containing that bad track, automatically using 
the substitute track instead. 

Advantages of Track Substitution 

The methods of dealing with bad tracks prior to track substitution capability were often 
time consuming. The file in which a bad track occurred had to be unloaded (if possible), deallo- 
cated, reallocated so as not to include the bad track, and finally reloaded. A bad track in a 
critical area caused special difficulty. If the bootstrap track was bad, the volume could not be 
used as a system residence volume (because it could not be bootstrapped). If either the volume 
label track or any track in the volume directory was bad, the volume could not be used at all. 

With track substitution capability, however, the occurrence of a bad track is of little significance 
to the usability of a volume. 


Exceptions to this rule are noted in documentation of individual system programs. 
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Preparing the Volume for Track Substitution 

Bad track handling capability is an integral part of the operating system software, but its 
use is dependent on the method of preparation of the individual mass storage volume. In order to 
substitute spare tracks for bad tracks on a volume, the volume must have been processed to 
create that capability, either initially by Volume Preparation C or by Volume Modification D at 
some time after initial volume preparation. 

THE TRACK SUBSTITUTION FILES: *BADTRACKS AND *VOLSPARES 

When the track substitution capability has been created on a mass storage volume, that 
volume differs from other volumes in that it contains two additional files: the bad tracks file 
(named *BADTRACKS) and the spare tracks file (named *VOLSPARES). The *BADTRACKS 
file contains a permanent list of all bad tracks ever encountered and declared on the volume. 

The *VOLSPARES file consists of all the tracks available for use as substitutes for bad tracks. 

Each data item in the *BADTRACKS file contains the address of a bad track and the ad- 
dress of its assigned substitute track in the*VOLSPARES file, as well as certain status informa- 
tion. The two files are normally allocated together in a single unit of allocation of standard size 
and location by Volume Preparation C or Volume Modification D, although, if necessary, the 
user can select a different size or location for that unit of allocation. 

*BADTRACKS File 

The *BADTRACKS file is a standard sequential file. Once it is created by Volume Prep- 
aration C or Volume Modification D, it can be deallocated, allocated, loaded, or unloaded like 
other sequential files. The user, however, need not ordinarily process the *BADTRACKS file 
directly, since it is used primarily for reference by the system software. For example, after 
each run of Volume Modification D, for whatever purpose, the user receives a printer listing of 
all known bad tracks on the volume and their assigned substitutes, as derived from the latest up- 
dated contents of the *BADTRACKS file. 

*VOLSPARES File 

The *VOLSPARES file is a file of nonstandard organization. It cannot be processed by 
file -oriented programs, including File Support C and Logical I/O C. Since each utilized track 
in the *VOLSPARES file is a substitute for a bad track in some other file, the contents of the 
*VOLSPARES file are fully accessible by logical references within the files containing the bad 
tracks for which the utilized tracks were originally substituted. 


B-2 


#3-619 


I 


APPENDIX B. BAD TRACK HANDLING PROCEDURES 


T 


Encountering a Bad Track 

When an uncorrectable read error occurs on a mass storage volume, the system has by 
definition encountered a bad track. The response of the software varies from program to pro- 
gram and also depends on whether the user has elected to include track substitution capability on 
the volume involved. 

In an environment without track substitution capability (that is, on a volume for which no 
*BADTRACKS and *VOLSPARES files have been created) the system executes a standard periph- 
eral device condition halt or console message to indicate a read error, the peripheral control 
unit number, and the device number. In addition, the cylinder and track address of the bad track 
is available to the user in the supplementary list. (In Volume Preparation C, a write error is 
indicated, and the printer lists the message: CYL nnn TR nnn ERROR. ) See Table B-l for the 
location of the bad track address in the supplementary list. 

When a bad track is encountered in an environment where track substitution capability has 
been elected, a substitute track can be assigned or established for the bad track. A substitute 
track is assigned to a bad track that is not part ofafile on the mass storage volume. A substitute 
track is established for a bad track that is part of a file on the mass storage volume. Volume 
Preparation C automatically assigns a substitute track from the *VOLSPARES file, updates the 
*BADTRACKS file, and continues surface checking the newly formatted volume; at the end-of-run, 
the printer lists the addresses of any bad tracks encountered and all substitute tracks. 

When a bad track is encountered during allocation of a file, and track substitution capabil- 
ity exists, the allocate function automatically establishes a substitute track for the bad track; 
the process of establishing a substitute track is defined and described below under the next 
heading. 

When a bad track is encountered while running other system programs or user programs 
together with Logical I/O C, a peripheral device condition halt or console message is produced 
to indicate a read error, the peripheral control unit number, and the device number. In addition, 
the address of the bad track is contained in the supplementary list. The cylinder, track, and 
record address is given as three 2 -character binary numbers. (For Volume Preparation C, 
Volume Modification D, and Disk/Tape Copy C, the bad track address is given in two 3 -charac- 
ter decimal numbers indicating cylinder and track. ) 
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Table B-l. Mass Storage Peripheral Device Error Information 
(Supplementary list begins at location A+l. Cylinder 
and track address of bad track is shaded. ) 


A-Address 

Register 

Location 

Volume 
Preparation C 

V olume 
Modification D 

Mass Storage 
Sort C 

Disk/Tape 
Copy C 

Logical I/O File 
Support & Pro- 
Gram Develop- 
ment Subsystem 

A-Address 

Register 

Location 

A 

response 

response 

response 

response 

response 

A 

A + 1 

specific code 

specific code 

specific code 

specific code 

specific code 

A + 1 

A + 2 



pcu 



A + 2 

A + 3 



device 



A + 3 

A + 4 

volume name 

volume name 

pack 

input volume name 


A + 4 

A + 5 

6 characters 

6 characters 

cylinder 

6 characters 
(alphanumeric ) 

file name 

A + 5 

A + 6 

(alphanumeric ) 

(alphanumeric ) 

2 characters 
(binary) 

1 0 characters 
(alphanumeric ) 

A + 6 

A + 7 



trecV 



A + 7 

A + 8 



2 cherectere 
tblnery! 

device type code 


A + 8 

A + 9 

volume serial number 

volume serial number 

record 

pcu 


A + 9 

A + 10 

6 characters 
(alphanumeric) 

6 characters 
(alphanumeric) 

2 characters 
(binary) 

d e vi c e 


A + 10 

A + 1 1 




pack 


A + 1 1 

A + 12 





relative 
volume number 

A + 12 

A + 13 






A + 13 

A + 14 

pcu 

pcu 


output volume name 

volume name 

A + 14 

A + 15 

device 

device 


6 characters 
(alphanumeric ) 

6 characters 
(alphanumeric ) 

A + 15 

A + 16 

pack 

pack 


A + 16 

A + 17 

cylinder 

cylinder 




A + 17 

A + 18 

3 characters 
(decimal) 

3 characters 
(decimal) 


device type code 


A + 18 

A + 19 




pcu 

pcu 

A + 19 

A + 20 

track 

track 


device 

device 

A + 20 

A + 21 

3 characters 
(decimal) 

3 characters 
(decimal) 


pack 

pack 

A + 21 

A + 22 




cylinder 

cylinder 

A + 22 

A + 23 




3 characters 
(decimal) 

2 characters 
(binary) 

A + 23 

A + 24 


file name (if any) 



track 

A + 24 

A + 25 


1 0 characters 
(alphanumeric) 


track 

2 characters 
(binary) 

A + 25 

A + 26 




3 characters 
(decimal) 

record 

A + 26 

A + 27 




• 

2 characters 
(binary) 

A + 27 

Etc. 




file name (if any) 







1 0 characters 
(alphanumeric) 


Etc. 


( 
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Establishing a Substitute Track in a File 

When a bad track occurs within the area of allocation for a file, the spare track substituted 
for it is said to be established . Establishing a substitute is accomplished automatically at alloca- 
tion time by File Support C, or by Volume Modification D after a file has been allocated. 

Establishment of a substitute track in a file involves (1) linking the substitute track to the 
track that follows the bad track in the file; (2) formatting the substitute track in accordance with 
the file’s allocation parameters; (3) entering the name of the file containing the bad track, and 
the addresses of the bad track and the substitute track, into an item in the *BADTRACKS file; 

(4) writing onto the bad track a bad-track track-linking record (TLR), which points to the sub- 
stitute track; and (5) setting a field in the volume directory (character position 15 of the file's 
*VOLDESCR* entry) to indicate the presence of bad tracks in the file. 

A substitute track can be established by the allocate function of File Support C when a bad 
track is encountered during allocation or by Volume Modification D when the user submits a 
Track statement declaring' the cylinder and track address of each bad track encountered in a file 
after allocation. 

When Volume Modification D establishes a substitute track, it also transfers all records 
containing file data from the bad track to the sustitute track; in addition, the header area and 
contents of any record for which a read error is detected are printed out as accurately as possi- 
ble for the user's inspection. At the end-of-run, Volume Modification D also produces a printer 
listing of all known bad tracks and all substitute tracks on the volume. 

During allocation, of course, there is no data to be transferred from a bad track to its 
substitute, since the file has not yet been loaded. 

All software of the Mod 1 (MSR) Operating System can process any file containing bad tracks 
if substitutes have been established for them by the allocate function or by Volume Modification D. 

FILE ORGANIZATION RESTRICTIONS ON ESTABLISHING SPARE TRACKS 

In order to establish a substitute for a bad track, the file containing the bad track must 
have been allocated with an integral number of blocks per track. In addition, if* a bad track is 
encountered in an indexed sequential file, no substitute can be established for it if the bad track 
is (1) the last track of the general overflow area, (2) the last track of the cylinder overflow area 
of any cylinder, or (3) the last track of the prime data area of any cylinder. If any of these re- 
strictions applies, the bad track is not assigned a substitute track, the substitute is not estab- 
lished in the file, and a halt or console message occurs. (If control panel I/O is used, the 


B-5 


#3-619 


APPENDIX B. BAD TRACK HANDLING PROCEDURES 


B-address register value 5455 appears during allocate and the value 6553 appears during Volume 
Modification D. If console I/O is used, the following message appears for both programs: FILE 
CANNOT CONTAIN BAD TRACKS. ) The halt or console message indicates that the file cannot 
have a substitute track established for the bad track without reallocation. If this condition occurs 
during allocation, the file must be deallocated before any further processing of the volume(s) 
involved. 

DEALLOCATING A FILE AFTER SUBSTITUTE TRACKS HAVE BEEN ESTABLISHED 

When a file containing bad tracks with established substitute tracks is deallocated, the bad 
tracks remain assigned to their respective substitute tracks. However, the file's name is re- 
moved from each entry in the *BADTRACKS file and the status field in those entries is set to in- 
dicate that the bad track is not contained within a file. 

BAD -TRACK TRACK -LINKING RECORD (TLR) 

When a substitute track is established for a bad track, the Volume Modification D or allo- 
cate program writes at least one readable bad -track TLR onto the bad track, linking it to the 
substitute track. Thus, subsequent references to the bad track will be automatically routed to 
the established substitute track by the system programs. In the event of gross physical abuse to 
the magnetic surface of a disk during handling or storage, it is conceivable that no readable bad- 
track TLR could be written. It is highly unlikely that this situation will ever occur during the 
normal life of any mass storage volume; if it should, however, a standard peripheral device 
write error halt or console message results and the printer produces the following message: 

CYL nnn TR nnn UNUSABLE. 

CONSIDERATIONS IN PROCESSING A VOLUME USING TRACK SUBSTITUTION 

The user gains the advantages of track substitution capability without having to make fun- 
damental alterations in his programs or previous operating procedures. In some cases, the 
following suggestions, if followed, will prove helpful. 

Direct Access Files 

Some difficulty may arise from the use of absolute bucket addressing in a direct access 
file that contains bad tracks. The mass storage address that can be obtained from the Logical 
I/O C communications area may be the address of a substitute track and, if so, cannot be re- 
turned to Logical I/O C as the absolute address of a bucket in the file. 
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Files Containing Mass Storage Address Information 

Occasionally, file items include fields that contain the mass storage address of another 
item in the file or of another file. If track substitution capability is to be used on files of this 
type, the addresses of these items should be calculated rather than retrieved from the mass 
storage address register. 

Substitute Bootstrap File 

If the bootstrap track (cylinder 000, track 000) of a volume is bad, a substitute bootstrap 
file can be created by a Track statement to Volume Preparation C or Volume Modification D. 
Volume Preparation C automatically creates the substitute bootstrap file if the bootstrap track 
is found to be bad during initial volume preparation. The substitute bootstrap file occupies a 
single track on cylinder 000. If a substitute bootstrap file is established by a Track statement 
on an existing system volume, Bootstrap Generator C should be rerun to insure the validity of 
the bootstrap information. 

Backup Procedures for the *BADTRACKS File 

The information contained in the *BADTRACKS file is critical to the continued successful 
processing of the mass storage volume and must therefore be protected against possible data 
loss, as could occur for example if a track in the *BADTRACKS file itself became bad. The 
*BADT RACKS file cannot, by system definition, contain any bad tracks. The following para- 
graphs describe measures that can be taken to protect the highly critical contents of the *BAD- 
TRACKS file. 

UNLOADING THE *BADT RACKS FILE 

The *BADTRACKS file can be unloaded by File Support C to any storage medium available 
to that program. Backup of the contents of the file can be obtained by periodically unloading the 
file to tape or cards. (If this backup procedure were performed after each run in which a change 
in the contents of the *BADTRACKS file has occurred, the data on the backup medium would pos- 
sess 100 percent validity at all times. ) 

RE-CREATING THE * BA DT RACKS FILE 

If a track in the ^BADTRACKS file becomes bad, the file must be moved to another area 
of the mass storage volume where good tracks exist. The *BADTRACKS file itself normally 
occupies not more than two tracks on the volume, using the standard size unit of allocation. 

(The *VOLSPARES file occupies the bulk of the three cylinders allotted to the track substitution 
files in the standard unit of allocation.) 
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Deallocating the *BADTRACKS File 

The *BADTRACKS file can be deallocated in exactly the same manner as any data file on 
the volume. Before deallocation is performed on this file, however, a halt or console message 
occurs to prevent inadvertent removal of the file. An appropriate response can be made to di- 
rect the system to perform the deallocation. 

Allocating the *BADT RACKS File 

The *BADTRACKS file is always initially created (at the same time as *VOLSPARES) by 
either Volume Preparation C or Volume Modification D. It can be re-created, following deallo- 
cation, by the allocate function. There are several special considerations when allocating *BAD- 
TRACKS, as follows: 

1. The *VOLSPARES file must already exist on the volume. 

2. The file name *BADTRACKS must be specified in the File statement. 

3. The file organization specified in the File statement must be "sequential. " 

4. No password may be specified. 

5. None of the parameters of the Size statement may be specified. 

6. Only one pair of FROM and TO parameters (one unit of allocation) 
may be specified in the Units statement. 

7. Only one Units statement may be specified. 

If any of the above requirements is not met, a halt or console message occurs and alloca- 
tion will not be performed. The appropriate values for item size and record size for the *BAD- 
TRACKS file will be set up by File Support C. 

Loading the *BADTRACKS File 

After the *BADTRACKS file has been moved to another area of the mass storage volume by 
use of the deallocate and allocate functions, the data on the backup storage medium can be loaded 
into the file by the load function of File Support C. 

Prior to actually loading data into the *BADTRACKS file, a halt or console message occurs 
to warn the operator and prevent inadvertent destruction of the file's data. An appropriate re- 
sponse can be made to direct the system to continue and to load the file. 

The Map Function 

When using the DESCR or EXPIRED options of the File Support C map function, the printed 
description produced for each file on the volume indicates whether that file contains bad tracks. 
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BAD TRACK HANDLING PROCEDURES FOR VOLUME PREPARATION C 

The user must give special attention to the subject of bad tracks on a mass storage volume 
that is being prepared by Volume Preparation C. Before Volume Preparation C is run, the user 
may be aware that one or more bad tracks exist on the volume to be prepared. In addition, while 
Volume Preparation C is formatting the volume in question, one or more bad tracks (previously 
unknown) may be encountered on the volume. 

Before running Volume Preparation C, the user must decide whether he wants it to assign 
substitutes for bad tracks on the volume. 


Track Substitution Not Requested 

If the user does not wish Volume Preparation C to assign substitutes for bad tracks on the 
volume, he merely creates a job control file as instructed in Section II of this manual. If a bad 
track is encountered on the volume during formatting, a halt or console message occurs. In ad- 
dition, the address of the bad track is given by the following message, which appears on the 
printer: CYL nnn TR nnn ERROR (nnn is a decimal value). 

If desired, the user can achieve the track substitution capability at a later time by running 
Volume Modification D (see Section VII of this manual). 

NOTE: When allocating files to a volume that does not contain *BADTRACKS 

and *VOLSPARES files, the user must be careful not to include in the 
units of allocation any bad tracks that have not been assigned substitutes. 


Track Substitution Requested 

When the user wishes Volume Preparation C to assign substitutes for bad tracks on the 
volume, he must include the appropriate special values in the job control file. ^ 

1. The spares parameter must be included (with an appropriate value) to 
create the *BADTRACKS and *VOLSPARES files. 

2. The FROM and TO parameters are used only when the *BADTRACKS 
and #VOLSPARES files are to be created in a nonstandard area. (In 

this case, the spares parameter must have the value SPARES = RELOCATE,.) 

3. A Track statement may be used to declare a bad track, known to the user 
before the run, for which a substitute is requested. Track statements 
are especially useful when the entire volume is not to be surface checked 
by formatting (because substitutes will not be assigned for bad tracks in the 
unformatted area unless these bad tracks are declared in Track statements). 


See "Job Control Language Supplement, " later in this appendix, for a complete description of 
job control language elements specific to bad track handling during Volume Preparation C. 


B-9 


#3-619 



APPENDIX B. BAD TRACK HANDLING PROCEDURES 


When the *BADTRACKS and *VOLSPARES files have been created on the volume during 
Volume Preparation C, track substitution occurs automatically, as follows: 

1. A substitute track is assigned for every bad track declared in a 
Track statement. 

2. A substitute track is assigned for every bad track encountered in the 
area formatted during the run. * 

No halt or console message occurs when a substitute is assigned for a bad track. 

Just before end of run, the printer lists (1) each bad track declared in a Track statement, 
(2) each bad track encountered in the formatted area, and (3) all substitute tracks. This printer 
listing is called the list file. 

Special Situations 
SITUATION 1 

A special situation exists if Volume Preparation C is being run without the track substitu- 
tion capability (no spares parameter has been included in the job control file) and a bad track is 
encountered in one of the following areas: 

1. The bootstrap track, 

2. The volume label track, or 

3. A track in the volume directory. 

If any of these tracks is bad, a halt or console message occurs. If the volume label track 
or a track in the volume directory is bad, Volume Preparation C must be run again with the 
spares parameter included in the job control file to create the ^BADTRACKS and *VOLSPARES 
files. A substitute track can then be assigned for the bad track when it is encountered during 
this run (or the bad track can be declared in a Track statement). If the bootstrap track is bad, 
Volume Preparation C can be run again, as described above. 

If no substitute track were provided for a bad bootstrap track, the volume could not be used 
as a system residence volume (because the volume could not be bootstrapped). 

If no substitute were provided for a bad volume label track or a bad track in the volume 
directory, the volume could not be used. 

SITUATION 2 

Track substitution is not possible for a bad track in the ^BADTRACKS file; therefore, a 


Volume Preparation C formats and surface checks either the entire volume or only certain 
critical tracks. See the "Surface-Check Parameter" in Section II of this manual. 
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bad track in the *BADTRACKS file cannot be declared in a Track statement. If a bad track is en- 
countered in the *BADTRACKS file during formatting of the volume, a halt or console message 
occurs . 

Volume Preparation C must be run again to relocate the *BADTRACKS and *VOLSPARES 
files. The spares parameter must have the value SPARES = RELOCATE, . ) A pair of FROM and 
TO parameters must follow the spares parameter. 

SITUATION 3 

Track substitution is not possible for any unusable track on the volume. "Unusable" means 
that the track surface is bad and not even one bad-track track- linking record can be read. (It is 
very unlikely that any track will ever be unusable. ) 

If any of the tracks mentioned in "Situation 1” is unusable, the result is the same as if the 
track were bad and no substitute track were provided (see the last two paragraphs of "Situation 1"). 

If a track in the *BADTRACKS file is unusable, the result is the same as if the track were 
bad (see "Situation 2"). 

If any other track on the volume is unusable and *BADTRACKS and &VOLSPARES files have 
been created, the following message appears on the printer: CYL nnn TR nnn UNUSABLE (nnn is 
a decimal value). 

Job Control Language Supplement 

The following elements of job control language exist to assist the user in handling bad 
tracks during Volume Preparation C. These elements - the spares parameter, the FROM and 
TO parameters, and the Track statement - form a supplement to the job control language for 
Volume Preparation C described in Section II of this manual. The placement of these elements 
in the job control file is illustrated in Figure B-l. 

SPARES PARAMETER 

The spares parameter must be included in the job control file when the user desires to have 
Volume Preparation C create the *BADTRACKS and *VOLSPARES files. The spares parameter 
can appear anywhere in the Volume statement. 
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Figure B-l. Placement of Supplementary Elements in Job Control File 


If the user specifies the value SPARES = YES, the *BADT RACKS and *VOLSPARES files 
will be created in a standard area on the volume. If the user specifies the value SPARES = 
RELOCATE, the *BADTRACKS and *VOLSPARES files will be created in an area specified by 
the user in a pair of FROM and TO parameters. (When the RELOCATE option is specified, the 
spares parameter must be followed by a pair of FROM and TO parameters. ) 


The form of the spares parameter is shown below. 


SPARES = 


YES 

NO 

RELOCATE 


) 


Y ES = A *BADTRACKS and a *VOLSPARES file are to be created in a standard 
area on the volume being prepared. The two files will occupy all of the 
tracks in the following standard areas. 


I 


Device Type 

Cylinders 

155 

200 - 202 

258 

101 - 103 

259, 273, 259A, 259B 

200 - 202 

261, 262 

125 - 127 


1/5/70 
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NO = The *BADTRACKS and *VOLSPARES files are not to be created. 

RELOCATE = A *BADTRACKS file and a *VOLSPARES file are to be created in 

an area specified by the user. This option may be used if these files 
cannot be created in the standard area. The RELOCATE option must 
be followed immediately by a pair of FROM and TO parameters. 

Default assumption: NO 
FROM AND TO PARAMETERS 

A pair of FROM and TO parameters is used only when the RELOCATE option has been 
specified in the spares parameter. The pair of FROM and TO parameters enables the user to 
designate the area on the volume where the *BADTRACKS and *YOLSPARES files are to be 
created. The pair of FROM and TO parameters must immediately follow the spares parameter 
in the job control file (as shown in Figure B-l). 


The form of this parameter is shown below. 


FROM = (ccc, ttt), TO = (ccc, ttt), 


ccc = The cylinder address, in decimal, where leading zeros are not 
required. 

ttt = The track address, in decimal, where leading zeros are not re- 
quired. The first track on each cylinder is numbered zero. 

The pair of FROM and TO parameters specifies that the &BADTRACKS and *VOLSPARES 
files are to occupy the following area of the mass storage volume: all the tracks from the track 
stated in the FROM parameter to the track stated in the TO parameter (inclusive) on each cyl- 
inder from the cylinder stated in the FROM parameter to the cylinder stated in the TO parameter 
(inclusive). 

The area designated by a pair of FROM and TO parameters can be as large as the user de- 
sires or as small as two tracks (one track for the #BADTRACKS file and one for the #VOLSPARES 
file). The user -designated area can be located anywhere on the volume except where it would 
conflict with the bootstrap track, the substitute bootstrap track, the volume label, or the volume 
directory. 

TRACK STATEMENT 

A Track statement can be used to indicate the address of a bad track for which a substitute 
is to be made. When a Track statement is used, the address of the bad track must be known 
before Volume Preparation C is run. 
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The use of Track statements requires that the *BADTRACKS and *VOLSPARES files be 
created by Volume Preparation C. 

A separate Track statement is required for each bad track that the user wishes to declare. 1 
Any number of Track statements may be included, but they must follow all other job control 
statements of Volume Preparation C. 

The format and placement of the Track statement are shown in Figure B-l. The cylinder 
and track address of each bad track (ccc, ttt, ) is expressed in. decimal numbers: leading zeros 
are not required. 

Operator Communication and Control Supplement 

The following halts and console messages are related to conditions involving bad or un- 
usable tracks when Volume Preparation C is being run. The user should also note the pp2d halt 
(specific code 10) in Table 2-5 and the WRITE ERROR console message (specific code 8) in 
Table 2-8: both tables appear in Section II of this manual. 


CONTROL PANEL HALTS 


Table B-2. Supplementary List of Halts Specific to Volume Preparation C 


B -Address 

Register 

Contents 

Condition 

Operator Action 1 

6502 

There is a bad track in t>he 
*BADTRACKS file. (The 
* BA DT RACKS file must be 
relocated. ) 

E = exit to the Supervisor. 

6503 

The volume label track or a 
track in the volume directory 
is unusable. 2 (The volume 
cannot be used. ) 

E = exit to the Supervisor. 

6504 

The bootstrap track (cylin- 
der 000, track 000) is un- 
usable.^ (The volume can- 
not be used as a system 
residence volume; i.e., it 
cannot be bootstrapped. ) 

A = accept the condition 
and continue prepa- 
ration of the volume. 

E = exit to the Supervisor. 


The user is not required to include a Track statement to declare a bad track if that track is in 
an area that is to be formatted by Volume Preparation C. When the bad track is encountered 
during formatting, a substitute track will be assigned for it (if the *BADTRACKS and 
*VOLSPARES files have been created). 
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Table B-2 (cont). Supplementary List of Halts Specific to Volume Preparation C 


B -Address 

Register 

Contents 

Condition 

Operator Action* 

6506 

An attempt is being made to 
process a Track statement, 
but the *BADTRACKS and 
#VOLSPARES files have not 
been created on the volume. 

E = exit to the Supervisor. 

'''The operator enters the appropriate response character and presses RUN 
(A = 2 lg, E = 25 g ). 

2 

"Unusable" means that the track surface is bad and not even one bad-track track- 
linking record can be read. (It is very unlikely that any track will ever be unusable. ) 


CONSOLE MESSAGES 


Table B-3. Supplementary List of Messages Specific to Volume Preparation C 


Typewriter Message 

Condition 

Operator Action* 

BAD TRACK IN 
*BADTRACKS FILE 

There is a bad track in the 
* BA DT RACKS file. (The 
*BADTRACKS file must be 
relocated. ) 

E = exit to the Supervisor. 

UNUSABLE TRACK 
IN DIRECTORY OR 
LABEL 

The volume label track or a 
track in the volume directory 
is unusable. 2 (The volume 
cannot be used. ) 

E = exit to the Supervisor. 

UNUSABLE BOOT- 
STRAP TRACK 

The bootstrap track (cylinder 

000, track 000) is unusable. 2 
(The volume cannot be used as 
a system residence volume; 

1. e. , it cannot be bootstrapped. ) 

A = accept the condition 
and continue prepa- 
ration of the volume. 

E = exit to the Supervisor. 

*BADTRACKS NOT 
ON VOLUME 

An attempt is being made to 
process a Track statement, but 
the * BADTR AC KS and 
*VOLSPARES files have not 
been created on the volume. 

E = exit to the Supervisor. 

The operator types the appropriate alphabetic response character and presses the 
space bar. 

2 

"Unusable” means that the track surface is bad and not even one bad-track track- 
linking record can be read. (It is very unlikely that any track will ever be 
unusable. ) 
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BAD TRACK HANDLING PROCEDURES FOR MASS STORAGE SORT C 

The presence of bad tracks inany of the volume areas usedfor workfiles by Mass Storage SortC 
slightly alters the calculations involved in determining whether to use single or double buffering. 

Table B-4. Disk Table (Bad Tracks Present on Type 155, 258, 

259, 273, 259A, or 259B Disk Pack Drives) 


Column A 

Column B 

Data 


Characters 

Records 

Per Block 

Per Block 

241 

1 

741 

3 

1, 241 

5 

3, 741 

15 


Table B-5. Disk Table (Bad Tracks Present 
on Type 261 or 262 Disk Files) 


Column A 

Column B 

Data 

Characters 

Records 

Per Block 

Per Block 

241 

1 

491 

2 

741 

3 

1, 241 

5 

1, 491 

6 

2, 491 

10 

3, 741 

15 

7,491 

30 


When the work files are on Type 155, 258, 259, 273, 259A, or 259B Disk Pack Drives, use 
Table B-4. When the work files are on Type 261 or 262 Disk Files, use Table B-5. Select from 
column A of the appropriate disk table the least value that is greater than or equal to the sort- 
item size (SIS). Let that value be represented by PBS (physical block size). 

Using the PBS value determined from Table B-4 or B-5, refer to Appendix A to calculate 
whether single or double buffering will be used. (In Appendix A, Table A-l or A-2 is used to 
determine the PBS, based on the assumption that there are no bad tracks present within the 
work files. ) 

BAD TRACK HANDLING PROCEDURES FOR DISK/ TAPE COPY C 

The following paragraphs describe Disk/ Tape Copy C procedures when *BADTRACKS and 
*VOLSPARES files are present. 
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Disk-to-Tape Copy — Track Substitution on Input Disk 

If the input mass storage volume contains *BADTRACKS and #VOLSPARES files and track 
substitution has occurred for one or more bad tracks in an area to be copied, the following 
action takes place (regardless of the copy method): when a bad input track is encountered, data 
is copied from the substitute track designated by the bad-track track-linking record (TLR) on 
the bad track. Header areas on the output tape record are modified to show the address of the 
bad track itself; thus, the output tape record is written as if no bad tracks existed on the input 
mass storage volume. 

Tape-to-Disk Copy — Track Substitution on Output Disk 

When *BADTRACKS and *VOLSPARES files exist on the output mass storage volume, the 
following action occurs: before data is copied to it, each output disk track is searched for a 
bad-track TLR. If none is found, the input data is copied to the output disk track. If, however, 
an output track contains a bad-track TLR, the input data is copied to the substitute track indi- 
cated by the bad-track TLR. (The bad-track TLR presumably links to a substitute track in the 
*VOLSPARES file. ) No halt or console message occurs but a BAD TRACK TLR message 
appears on the printer. 

PRECAUTION 

When file data is copied to a substitute track on an output disk (because the intended output 
track was bad), the *BADTRACKS file must reflect the file-related status of the bad track. If 
the file-related status of a bad output track has not already been established by allocate or 
Volume Modification D, the user must follow one of the procedures outlined below. 


* 
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Procedure A 

1. Run Volume Preparation C or Volume Modification D for the output disk, 
including the spares parameter to create the *BADTRACKS and 
*VOLS PARES files. (If *BADTRACKS and -VOLSPARES files already 
exist on the output disk, this step can be omitted. 1 

2. Allocate to the output disk all files involved in the copy. ^ (The file- 
related status of each bad track is now established. ) 

3. Perform a tape-to-disk copy run, copying from the tape all desired areas 
except the volume directory and the *BADTRACKS and *VOLSPARES files. 


Procedure B 

1. Allocate to the output disk all files involved in the copy. 

2. Run Volume Modification D for the output disk, including (1) a spares 
parameter to create the *BADTRACKS and &VOLSPARES files and 
(2) a Track statement for each bad track. (The file-related status 

of each bad track is now established. ) 

3. Perform a tape-to-disk copy run, copying from the tape all desired 
areas except the volume directory and the *BADTRACKS and 
*VOLSPARES files. 


Disk-to-Disk Copy 

TRACK SUBSTITUTION ON INPUT DISK 

The procedure is the same as that described under "Disk-to-Tape Copy" except that the 
output volume is mass storage. 


TRACK SUBSTITUTION ON OUTPUT DISK 

The procedure is the same as that described upde’r "Tape-to-Disk Copy" except that 
the input volume is mass storage. 

Suggested Method for Creating Disk Backup With Track Substitution Capability 

The following procedure is suggested when the user desires to create disk backup with 
track substitution capability. 


^See also "Precautions When Using Disk/Tape Copy C" in Section VI if the copy-by-rectangle 
method is to be used. 


1/5/70 


B-18 


#3-619 





APPENDIX B. BAD TRACK HANDLING PROCEDURES 


PHASE 1 — CREATING A BACKUP TAPE 

Perform a disk-to-tape copy run using the copy-by-rectangle method. (The input disk is 
the volume for which backup is desired. ) Specify two (or more) pairs of FROM and TO parame- 
ters in the Input Volume statement: the first pair must delimit only the input volume directory, 

the second (and any subsequent) pair must delimit only the input disk area for which backup is 
desired. (No portion of the *BADTRACKS and ^VOLSPARES files is to be included in the area 
delimited by the pairs of FROM and TO parameters. ) 

PHASE 2 — COPYING FROM THE BACKUP TAPE TO AN OUTPUT DISK 

1. Perform steps 1 through 3 outlined for "Procedure A" under "Tape-to-Disk 
Copy. " 

2. Perform a tape-to-disk copy run, copying to the output disk the second (and 
any subsequent) rectangle copied to the backup tape in phase 1, above. 

(The volume directory of the original input disk has been copied to the 
output disk by step 2 of Procedure A. ) 
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